Kennis is macht. Verspreide macht zonder focus is nutteloos. In klare taal: de visie en doelstelling van het Slackware Linux Documentation Project is om wereldwijd de primaire bron te worden voor alle Slackware gerelateerde informatie. Zo'n doelstelling legt de lat hoog. Maar toch hebben we er vertrouwen in dat het gerespecteerde Slackware Linux, de oudste nog actief onderhouden distributie van GNU/Linux, de juiste gebruikers gemeenschap heeft om dit doel te bereiken. Je bent hierbij uitgenodigd om toe te treden als partner in deze onderneming.

Wie kan hierbij helpen? Iedereen kan dat doen, van je ome Ed die wat met Slackware rotzooit op zijn oude laptop, tot Linux gurus met ervaring in Linux ontwikkeling. Allemaal zijn ze welkom. Iedereen kan wel iets bijdragen dat waardevol is voor dit project. Een op Wiki gebaseerd documentatieproject staat of valt met de betrokkenheid vanuit de gemeenschap. Je hebt natuurlijk kunnen zien wat de GNU/Linux en Open Source gemeenschappen in het verleden hebben bereikt en nog steeds kunnen bereiken. Wanneer we samenwerken, wordt het potentieel voor succes alleen maar groter.

Dit project is gebaat bij artikelen die ingediend worden die het volledige spectrum van Slackware kennis omvatten. Er is behoeft aan diepgaande technische artikelen over hardware controle, software applicaties, Slackware Linux implementaties in bedrijven als ook gewoon thuis, systeembeheer, etc. Ook zijn verhalen welkom van de alledaagse “Slacker” die onderwerpen bestrijken van simpele HOWTOs tot complexe oplossingen en alternatieven voor veelvoorkomende problemen.

Alle ingediende artikelen zullen, zoals gewoon is bij Wiki-gebaseerde projecten, aan peer review worden onderworpen, wat neerkomt op feedback van de overige SlackDocs leden. Soms zullen correcties nodig zijn, of verduidelijkingen in de tekst, enzovoort. Geen enkel artikel zal onbelangrijk geacht worden. Is het relevant voor Slackware? Zal het iemand anders in staat stellen om dit Operating Systeem beter te benutten? Dan is het de moeite waard. Wat wij hier doen, doen we voor anderen. Wij bouwen hier aan een fundament van kennis dat de toekomst moet weerstaan. Jouw deelname is de specie en de bouwstenen voor dat fundament.

Om deze doelstellingen waar te kunnen maken, is het van belang dat we elkaar met respect benaderen en er een sterke geest van samenwerking heerst in dit samenwerkingsverband. Wij hanteren een eenvoudige set regels. Wees vriendelijk en begripvol in je discussies met anderen. Dit project is er niet voor het individu. Het gaat hier om het kunnen delen (van kennis) binnen de gemeenschap en om het kunnen samenwerken aan een gemeenschappelijk doel. Jouw ego zal geen deel worden van het Slackware Linux Documentation Project. Laat het asjeblieft achter aan de kapstok naast de voordeur voordat je inlogt.

Dat is het contract dat we met elkaar afsluiten en met de toekomst.

Deze Wiki draait op de DokuWiki software. Dit was een keus die door de initiator van het project, Alien BOB gemaakt is. In essentie zijn er twee mogelijkheden wanneer een serieuze Wiki opgezet moet worden: MediaWiki en DokuWiki. Alien BOB heeft uitgebreide ervaring met beide - DokuWiki is de motor van zijn eigen Slackware kennisbank, en hij beheert een op MediaWiki gebaseerde kennisbank voor de IT Helpdesk waarvan hij teamleider is.

De keuze is op DokuWiki gevallen vanwege een aantal redenen: diens eenvoudige syntax maakt het beter geschikt voor het document-gericht schrijven. Dit in tegenstelling tot MediaWiki, dat meer algemeen georienteerd is. Ook is een DokuWiki installatie een onafhankelijk geheel; in een enkele directory en zonder de noodzaak voor een SQL database. Dit maakt dat een DokuWiki installatie gemakkelijk over te brengen is naar een nieuwe server (de intentie is om een “dagelijks snapshot” archief beschikbaar te maken als download wanneer het Wiki fundament compleet is). De DokuWiki kent ook ACL (Access Control Lists ofwel granulaire toegangscontrole). Wij zullen hiermee een vorm van kwaliteitscontrole implementeren wanneer we een goed werkend team van editors hebben verzameld (dwz de mensen die verantwoordelijk gaan worden voor de kwaliteit van de website en diens artikelen terwijl jullie, de auteurs, verantwoordelijk worden voor de feitelijke inhoud van die artikelen).

De basis DokuWiki installatie is inmiddels voorzien van diverse plugins die de syntax mogelijkheden aanzienlijk uitgebreid hebben. Die plugins worden vermeld onder aan de Wiki syntax pagina. Je kunt de link bij deze plugins volgen naar de respectieve websites om daar te weten te komen welke toegevoegde functionaliteit ze bieden voor het schrijven van goede documentatie.

Het beeldmateriaal dat momenteel gebruikt wordt voor deze website werd gecreëerd door asteroid. Op zijn eigen Wiki pagina heeft hij nog wat meer aardige voorbeelden van logo's.
De admins hebben Patrick Volkerding gevraagd (en ook toestemming gekregen) om deze modificaties van origineel Slackware beeldmateriaal op onze Wiki te mogen gebruiken.

Aan de linkerkant van de pagina zie je een zijbalk, met daarin een aantal afgebakende blokken. Deze kunnen door de admins worden aangepast. Enkel het “gereeedschappen” blok is standaard onderdeel van de Wiki's monobook sjabloon, en kan daarom niet worden aangepast. Een verandering in dat blok zou toekomstige upgrades van de Wiki software lastiger maken.
Indien je suggesties hebt over pagina-verwijzingen waarvan je vindt dat die absoluut in een van de overige blokken in de zijbalk thuishoren, dan kun je ons dat laten weten via de (engelstalige) discussie pagina.

Ook al heeft de Wiki van ons documentatie project een hostname in het slackware.com domein, dan betekent dat nog niet dat dit project ook door Slackware gecontroleerd of gesponsord wordt. Het gebruik van de domein naam mag beschouwd worden als een goedkeurings-stempel. Dat werd mede in de hand gewerkt door het feit dat dit project gestart is door Alien BOB, die een van de leden is van het “Slackware coreteam”.
De inhoud van de Wiki zal niet gereguleerd worden door enige “hogere macht”. De inhoud van iedere pagina in deze Wiki wordt volledig bepaald door diens auteur(s) en verdere contributeuren.

De basis-structuur van de Wiki wordt onderhouden door de project admins. Daaronder vallen: namespaces, visuele identiteit, toegangscontrole enzovoort. Ook betekent dit, dat de kern namespaces “slackware:”, “slackdocs:” en “slackbook:” niet gewijzigd kunnen worden tenzij je deel uitmaakt van het editor/admin team.

Suggesties voor veranderingen in de kernstructuur van de Wiki kunnen worden doorgegeven via onze mailing lijst (http://lists.alienbase.nl/mailman/listinfo/slackdocs) of door je suggestie achter te laten op de discussie page (engelstalig). De feitelijke inhoud van de Wiki wordt door jou bepaald! Wij staan open voor goede ideeën die de bestaande structuur (en inhoud) kunnen verbeteren. We zullen geen enkel artikel weigeren in de “howtos:” sectie dat binnen de doelstellingen van deze Wiki valt.

[Not implemented yet] Our goal is to give you total creative freedom when writing content for the Wiki. But for the sake of quality assurance, we ask you to co-operate with one of our editors.
He or she may be able to offer suggestions about tags to use in your article so that it gets properly listed in the TOC. We also have tag categories that allow you to indicate your article applies to certain versions of Slackware only. You get the idea? You can also discuss an appropriate namespace to put your article in (consider a namespace as a wiki equivalent of a subdirectory - actually that is how it is implemented in the server's filesystem). The editor's primary role is to advise you on the structure of your article, ensure that it looks good, uses well-formed sentences - essentially that what any book editor would also do for you. You (the author of the article) will remain in control over the technical content! The editor will not enter into discussions about the (technical) content of your article, unless he spotted blatant errors of course. We assume that since you wrote it, you know better what you are talking about than do we…

In order to assist the editor with his work, the Wiki implements a mechanism of “publishing a page”. This means that the creation of a new page, or editing an existing page, will automatically put that page in “Draft” mode. The “Draft” message will be prominently visible on the page. If you are editing an existing page, then the original (approved) page will remain be visible to visitors of our Wiki. Only the registered users of the wiki (i.e. your fellow authors) will be able to see the draft instead of the approved version.
You have to consult one of our editors to get your page revision approved. That action will make it visible to the world.

Indien een kopie van origineel werk van iemand anders in onze Wiki wordt gebruikt, zullen alle eventuele licenties en copyright bepalingen moeten worden gerespecteerd die aan het originele werk verbonden zijn.
De naam van de originele auteur(s) alsmede de originele locatie URL moeten worden genoemd in de voettekst van jouw (wellicht aangepaste) kopie van die tekst.

De inhoud van deze Wiki wordt gepubliceerd onder een liberale “Creative Commons” licentie: CC Attribution-Share Alike 3.0 Unported . Houd dit in de gaten wanneer je van plan bent om materiaal aan de Wiki toe te voegen waarop een copyright rust.

• Originele auteur: Eric Hameleers
• Bijdragen: V. T. Eric Layton