[Nitro] Nitro Documentation Project (NDP)

Robert Wagner robbie.wilhelm at gmail.com
Fri Sep 2 14:46:24 EDT 2005


2005/9/2, James Britt <james_b at neurogami.com>:
> Robert Wagner wrote:
> > hi,
> >
> > 2005/9/2, Michael Kohl <citizen428 at gentoo.org>:
> >
> >>4. Define which format to use. Wikis are undoubtedly nice, but we
> >>should at lest consider alternatives. E.g. Gentoo's documenation is
> >>written in GuideXML (http://www.gentoo.org/doc/en/xml-guide.xml), which
> >>then gets converted to HTML via xslt. That's pretty neat, as it allows
> >>us to generate different output from the same source easily. This may
> >>or may not be intersting for Nitro, but at least we should discuss it.
> >>
> >
> >
> > i like the gentoo doc stuff. when i was in the mood of documenting my
> > lib long time ago :) i imitated the looks and added
> > *direct-running-examples* and i like it still.
> > http://www.xorc.org/xorcdoc/form_1.php
> 
> Is anyone actually suggesting people write docs in XML?
>

aehm. *no*. what i do like is the layout. not the xml. i'd vote for markdown.

 -robert




More information about the Nitro-general mailing list