Hi ,
For some time now I was looking into possibilities of how to organize the
doco properly. And now there is no doubt in my mind that Docbook is the
right way.
Dockbook SGML and XML DTDs and accompaning DSSL and XSL stylesheets are
basically becoming a standard for doco markup. LDP , KDE, GNOME and may other
projects are standardizing on Docbook. There have been some brave attempts
to try to define "proprietary" doco DTD, like Apache projects, but it seems
to me that they are going to hit dead end and fold under Docbook dominanace.
During my work on a Jboss container paper I work with it itensively. It
is very easy to pick up. To get some feeling about it go here:
www.ariel.cs.yorku.ca/~cs962267/jbossfinal.xml
Predefined stylesheets allow you to make easily appropriate html views
like this one here:
www.ariel.cs.yorku.ca/~cs962267/doc.html and
www.ariel.cs.yorku.ca/~cs962267/index.html
and finally
www.ariel.cs.yorku.ca/~cs962267/jbossfinal.pdf that can be
easily customized even further.
Docbook references are here:
www.docbook.org
www.caldera.de/~eric/crash-course/HTML
www.linuxdoc.org/LDP/LDP-Author-Guide/
My suggestion is to move all jboss doco into docbook and then take it from
there with any view needed pdf html etc. I am volunteering to this if
Jboss doco moves in this direction.
Thanks,
Vladimir
