Hi ppl,
Just wanted to update you on my progress with documentation. I managed to
get few articles "docbook"-ed , write some XML-HTML XSL driver
customization as well as to get some ppl to create graphics for doco site.
For example, pay attention how TOC- Table of Contents widget takes you to
closest table of contents in level up, if pressed again you move up etc...
All of this is automatically generated and it is an ease to
generate/maintain.
See a preview of things to come at www.ariel.cs.yorku.ca/~cs962267
and this is just warming up :) !!!
Unfortunately I am leaving Toronto for Europe on Tuesday for some
snowboarding and to see my folks in Yugo. Will pick up when I return in
early January. If any folks have a few hours on a side you can help move
doco articles to Docbook , there are examples here:
www.ariel.cs.yorku.ca/~cs962267/docbook and you can use this reference
http://www.docbook.org/tdg/html/docbook.html
After that is just a matter of arranging the whole thing as well as
writing ANT build.
Very best and have a great holidays,
Vladimir
On Sun, 10 Dec 2000, marc fleury wrote:
> hehe,
>
> well it was the way done by Prof Dierker... shame it didn't go anywhere.
>
> I believe we really need to put significant wood behind the doco "arrow"
>
> The Manual and Howto need to come together and all subject covered in
> greater detail.
>
> It seems there is a talented team coming together on the subject.
>
> Please go ahead with the XMLification of the book, we have to get OReilly to
> publish it (in copy :)
>
> marc
>
>
> |-----Original Message-----
> |From: [EMAIL PROTECTED]
> |[mailto:[EMAIL PROTECTED]]On Behalf Of Vladimir A
> |Blagojevic
> |Sent: Sunday, December 10, 2000 7:24 AM
> |To: jBoss Developer
> |Subject: Re: [jBoss-Dev] Dockbook for documentation
> |
> |
> |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
> |> >
> |> >
> |>
> |>
> |>
> |
> |
> |
>
>
>
