Re: documentatie

[Janno de Wit <jdewit@nl.linux.org>]

On Mon, 31 Jan 2000, Gerrit Holl wrote:

> jdewit@rdnet.nl wrote on 949346836:
> > hoi jongens,
> > 
> > ik denk dat we onderhand wel documentatie kunnen gaan schrijven.
> > gewoon in simpele html
> 
> ?????
> We zijn het nog lang niet ergens over eens!

we zijn het nog niet eens over de opmaak. maar de kale documentatie kan
toch onderhand wel worden geschreven. Als is het dan kale documentatie
zonder opmaak, dat maakt niet uit. De opmaak kan toch later geregeld
worden. Laat ik het zo zeggen. We kunnen wel schrijven, en tegelijkertijd
de opmaak regelen. ik zie deze twee dingen gescheiden.

 > > > zoiets?
> > opmaak komt later wel als we eruit zijn.
> 
> Opmaak en inhoud is heel wat anders.

inderdaad, dus... waarom niet alvast documentatie schrijven.

> 
> > wie gaat trouwens een src2html regelen?
> 
> Ik. Volgens RFC 822, dat heb ik al uitgelegd.

mooi :)

> > gaan we het weer met voor / na files doen?
> > ... en pythonscripts.
> > 
> > genoeg om uit te 'vechten' op de nllgg.
> 
> Dan pas?

nee, hoor, we zijn er al mee begonnen. 

> > wat betreft de /druk en /eenvoud.
> > dit zou wel kunnen maar misschien iets voor later...
> 
> Waarom?

maak jij dan eens een lange mail, zoals jij het graag wilt zien!
als ik het niet goed doe, moet je dat zeggen!
 
> > daar hoeft immers niet veel aan gedaan te worden. de tekst hebben we al,
> > je draait src2html met de goede voor / na files en het is gebeurd.
> 
> Je draait geen src2html. Je commit een file, src2html wordt gedraaid,
> de HTML file wordt in twee verschillende formaten in twee dirs gezet
> en het is gebeurd.

snap ik, hartstikke mooi systeem.
 
> > dat is mijn stelling maar hoor, er zal wel nog meer aan te pas komen.
> 
> Minder dus.

nu weer meer ;)
 
> > dit is voorlopig genoeg denk ik.
> > documentatie is denk ik te schrijven over:
> > 
> > ms/windows/history.html
> >            whatis.html
> 
> "Wat is Windows?"? Dat weet toch iedereen?

nou en? daarom moet je het er nog wel bijzetten, ik vind het geen reden om
te zeggen 'we beschrijven niet wat windows is, omdat iedereen toch al weet
wat het is'


 > 
> > ms/dos/whatis.html
> > ms/history.html
> > unix/linux/whatis.html
> >            history.html
> > unix/history.html
>   unix/whatis.html

groeten,

Janno

-
Thinkquest:   lijst van het NL.linux.org thinkquest team
Archive:      http://mail.nl.linux.org/