Vladimir,
For the last days I've been talking to Marc trying to sync an enhanced
documentation effort for JBoss... Altought I'm a MS Windows geek, I can also
recognize the advantages other systems have. SGML/XML tools are obviously
the way to go, not MS Word. I belive you are suggesting a very powerful way
of organizing the doco... and since I'm working on some of the contents. I'd
love to find a way in that we could sync ourselves... What do you suggest?
Cheers,
Hugo
----- Original Message -----
From: "Vladimir A Blagojevic" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Sent: Sunday, December 10, 2000 7:26 AM
Subject: [jBoss-Dev] Dockbook for documentation
> 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
>
>
