Hi,
Cool. Lets see what other board people say, if it is ok vote, my guess
is that we have to talk to Aaron and Ken and we'll take it from there.
Until then check the references for docbook in previous email :)
Vladimir
On Sun, 10 Dec 2000, [iso-8859-1] Hugo Jos� Pinto wrote:
> 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
> >
> >
>
>
>
