Re: [naviserver-devel] Documentation & website question

[Bernd E. <b.e...@ki...>]

> NO. MORE burden!
> Please lets forget XML before we write yet another line on that.
>
> To my opinion, the tcl doctools format is the simplest most natural
> to understand and write format I've come accross when writing short(er)
> man pages. And this is the bulk of that we need....

Relax! I won't delete the src directory and replace it with XSLT scripts :-)
I felt into the format-discussion-trap again, sorry.

When using doctools we have various output formats available, nroff, html, 
tmml, latex, wiki (see src/README.doc). We can put stuff below docroot, into 
man/, on the wiki. The technical stuff and format is already there.

The general problem is: We don't _want_ to write documentation. Not for man 
pages and not for the Wiki.
If we make it a priority we can surely provide appropriate templates that 
everyone feels comfortable with. We just have to cut the Gordian knot.

Bernd.