I think, that the Gentoo documentation is one of the best in the web. The use XML or Guide XML. You can find more infos at the gentoo page: http://www.gentoo.org/doc/en/xml-guide.xml
Why ArchLinux do not use the same syntax? It´s very easy to learn, and looks better than a wiki. I think so
I made a litlle demo, quick and dirty, with the same files from the Gentoo docu, but the ArchLinux design.
There are only one line need, to build an html site:
xsltproc --novalid /home/campylobacter/test/guide.xsl demo.xml > /home/campylobacter/test/demo.html
Look here for the result: http://hollaus-it.at/archlinux/demo.html
It can be an alternative to the wiki system. Has it a worth?
Dennis and I discussed this when we set out to draw up documentation standards, but we decided it was one more markup for people to learn, and had a bit more cruft than the Arch "Keep It Simple" attitude desires.
We devised a documentation and styles guide based on XHTML. This IS the standard:
Although it is still open to change and suggestion, it is basically in its final form.
Ok, I have only read the wiki
It is an valid HTML 4.01 Transitional document, but XHTML is only a little bit different .
I think, that an xml file is more "Keep It Simple", and it has an independent design.
But the XHTML and css solution is also good.
Perhaps we start an german community with the XML-syntax
Correct me if I am wrong but the gentoo guide setup is just a CMS like plone or PHPX. Only i don't see anywhere how users can contribute to it like a wiki. I like the wiki layout much more than the multiple color scheme which gentoo employs in their documentation.
The markup language itself is still very chunky so I really don't see much advantage there.
I am not your friend