DOCUMENTATIESERVER OP DE PCW

Auteur: Roeland Kok
Datum : 21/03/2003


Overzicht

Dit document geeft een beeld van een nieuw plan voor een project binnen de 
PCW. Het is de bedoeling een documentatieserver op te zetten, die via alle 
bekende protocollen bereikbaar is. Denk hierbij aan beschikbaarheid via 
http, gopher, ftp en nfs. De server wordt opgezet door bezoekers van de 
PCW en zal voorlopig alleen intern bereikbaar zijn.


Het plan

Documentatie is in deze tijd erg belangrijk. Bij het werken met computers 
is het van vitaal belang dat de documentatie up-to-date en compleet is. 
Een speciale server op de PCW moet ervoor zorgdragen dat er een enorme 
verzameling van documenten, howto's en artikelen opgezet wordt die 
bereikbaar is vanaf elke PCW-computer. Zo nu en dan zal voor 
belangstellenden een CD-R gebrand kunnen worden met hierop de gewenste 
documentatie over uiteenlopende onderwerpen.

De documentatie moet worden aangeboden in open vorm. Dat wil zeggen dat de 
inhoud vrijgegeven moet zijn onder bijvoorbeeld een GNU licentie, zodat 
geen inbreuk gedaan wordt op auteursrechten. Ook de presentatie moet in 
open vorm plaatshebben. Geen gesloten formaten, maar zoveel mogelijk 
ASCII, XML, HTML of andere open formaten.

De server hoeft niet krachtig te zijn. Een computer in de late 486 of 
Pentium klasse met een harde schijf van enkele gigabytes moet voldoende 
zijn om voorlopig vooruit te kunnen.

Het opzetten van de server en het beheer wordt gedaan door bezoekers die
nog niet zo lang met Linux werken of er graag meer mee willen doen. Dit,
omdat het belangrijk is dat iedereen de kans krijgt om te leren werken met
het systeem. De geavanceerde opties van de server kunnen ook opgezet
worden door de gevorderde bezoekers, aangezien dit voor beginnende
Linuxers soms wat hoog gegrepen is.

Het onderhoud en de aanvulling van de documentatie zal gedaan worden door
de bezoekers en begeleiders. De handigste manier om dit te doen is om
iemand aan het zoeken te zetten als hij of zij een vraag heeft waar niet
makkelijk uit te komen is. De gevonden documentatie kan met behulp van het
FTP protocol geupload worden naar een centaal account, waar vandaan
eventuele procedures als indexeren e.d. door een cronjob gedaan zullen
worden.

Er wordt geen tijdsdruk op het project gelegd, aangezien het niet de 
bedoeling is dat er slordig gewerkt wordt, maar juist dat de betrokkenen 
wat leren van het opzetten van de documentserver.


Roeland Kok