You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by hiten pandya <h_...@hotmail.com> on 2001/07/09 16:55:45 UTC
hello everyone (regarding documentation)
hi everyone,
i am planning to start my own documentation project for Tomcat 3.3 and 4.0.
The different thing about this project is that, i am going to port all of
the tomcat documentation to XML Docbook format.
Though i am not very good at docbook but i think i can cope. Once the
documentation is complete, I will submit it to the main tomcat development
team.
I dont really know if this is the rite approach for writing documentation,
but i am open for suggestions.
It will be a funtime for my summer holidays as well.
Hiten Pandya
United Kingdom.
If anyone would like to help me write the documentation, please submit the
sections u will be working on to me at h_pandya5@hotmail.com.
But first i am waiting for enough good votes and bad votes about the
starting of this project.
Put [SUGGESTIONS] in the subject header so it is easier for me to fetch them
out of my mailbox.
Thanks in advance.
--------------------------------------------------------------------
The following are the details.
Document Language: XML
Format: DocBook 4.x(stable)
Binary Formats:
- Portable Document Format (PDF)
- HTML
- Latex
- PostScript
- Etc...
- Windows Help Format.
(text formats)
- ASCII
---------------------------------------------------------------------
Thanks in advance
hiten pandya
15
h_pandya5@hotmail.com
united Kingdom.
_________________________________________________________________________
Get Your Private, Free E-mail from MSN Hotmail at http://www.hotmail.com.
Re: hello everyone (regarding documentation)
Posted by Pier Fumagalli <pi...@betaversion.org>.
Quoting hiten pandya <h_...@hotmail.com>:
> hi everyone,
>
> i am planning to start my own documentation project for Tomcat 3.3 and
> 4.0. The different thing about this project is that, i am going to port all
> of the tomcat documentation to XML Docbook format.
>
> Though i am not very good at docbook but i think i can cope. Once the
> documentation is complete, I will submit it to the main tomcat
> development team.
>
> I dont really know if this is the rite approach for writing
> documentation, but i am open for suggestions.
>
> It will be a funtime for my summer holidays as well.
>
> Hiten Pandya
> United Kingdom.
>
> If anyone would like to help me write the documentation, please submit
> the sections u will be working on to me at h_pandya5@hotmail.com.
>
> But first i am waiting for enough good votes and bad votes about the
> starting of this project.
>
> Put [SUGGESTIONS] in the subject header so it is easier for me to fetch
> them out of my mailbox.
>
> Thanks in advance.
A nice way to duplicate the job, indeed... Why not joining Alex et. al and
write the documentation with them? Just because you want to do it with
the DocBook DTD? A ridiculous excuse, as with a very simple XSLT
stylesheet you can convert the Anakia DTD in DocBook with no fuzz...
Pier
Re: Suggestions (was Re: hello everyone (regarding documentation))
Posted by Christopher Cain <cc...@mhsoftware.com>.
Alex Fernández wrote:
>
> Hi Hiten!
>
> hiten pandya wrote:
> > i am planning to start my own documentation project for Tomcat 3.3 and 4.0.
> > The different thing about this project is that, i am going to port all of
> > the tomcat documentation to XML Docbook format.
>
> Not speaking officially, I'm not a committer: if you want to document
> Tomcat, then go ahead and good luck!
>
> Your focused work can do lots for the docs: you will probably end before
> the "committee" decides the right format for Tomcat docs :)
LLAMF! True that.
> Just a suggestion:
> > Though i am not very good at docbook but i think i can cope. Once the
> > documentation is complete, I will submit it to the main tomcat development
> > team.
>
> Don't wait till everything is ready; send your updates regularly to the
> dev list, so folks can criticize your work and point possible mistakes.
[snip]
Am I the only one that initially read that as "send your updates
regularly so that folks can criticize you and your pointless mistakes"?
Alex deals some very sage advice here, but when I first hit "Reply" he
was about to get some even higher praise for the funniest pointed
sarcasm I had heard in quite some time.
...
Uhhh ... I guess you had to be there. In any event, Alex's advice is
quite sound, FWIW.
Re: Suggestions (was Re: hello everyone (regarding documentation))
Posted by gu...@stinky.com.
On Tue, Jul 10, 2001 at 10:39:12AM +0200, Alex Fernández wrote:
> Hi Hiten!
>
> hiten pandya wrote:
> > i am planning to start my own documentation project for Tomcat 3.3 and 4.0.
> > The different thing about this project is that, i am going to port all of
> > the tomcat documentation to XML Docbook format.
>
> Not speaking officially, I'm not a committer: if you want to document
> Tomcat, then go ahead and good luck!
>
> Your focused work can do lots for the docs: you will probably end before
> the "committee" decides the right format for Tomcat docs :)
OK, I appreciate the :-) but... that's not *quite* fair. We're
closing in on a decision, and if you want to write new stuff now you
should just go ahead and do it. Use text or HTML or even Word. I
think using DocBook is premature.
I don't think a wholesale conversion of existing docs to DocBook will
be a good use of anyone's time right now. Maybe in a week or two
we'll be converting them to Anakia or DocBook but not just yet.
> Just a suggestion:
> > Though i am not very good at docbook but i think i can cope. Once the
> > documentation is complete, I will submit it to the main tomcat development
> > team.
>
> Don't wait till everything is ready; send your updates regularly to the
> dev list, so folks can criticize your work and point possible mistakes.
> That way, you can change course in a timely manner; otherwise you might
> find at the end that a chapter is unnecessary and another one is missing
> :)
Before you write a chapter (or article or HOWTO or whatever you want
to call it), please take a look at (a) the existing docs, and more
importantly (b) the Table of Contents and see if it fits in anywhere.
Then let the list know what you're working on. We're trying to
organize the docs so there's no redundant information.
(For instance, there's lots of information on configuring Apache
scattered among half a dozen howtos and FAQs right now. Most of it is
now out of date, and it'll be impossible to bring it all current. I'd
like there to be one chapter on "integrating with Apache," with
subsections for "mod_jk," "mod_webapp", "mod_jserv," and so on -- and
since the subsections can rely on the introduction of the Apache
chapter, they won't have to duplicate information that's already been
covered above, and won't confuse anybody. On the Tomcat Forum I
regularly get questions where people have read a mod_jserv howto
instead of a mod_jk howto and they don't even realize there's a
difference, since they're both called "Configuring Apache" without
mentioning the name of the connector.)
--
Alex Chaffee mailto:alex@jguru.com
jGuru - Java News and FAQs http://www.jguru.com/alex/
Creator of Gamelan http://www.gamelan.com/
Founder of Purple Technology http://www.purpletech.com/
Curator of Stinky Art Collective http://www.stinky.com/
Suggestions (was Re: hello everyone (regarding documentation))
Posted by Alex Fernández <af...@tid.es>.
Hi Hiten!
hiten pandya wrote:
> i am planning to start my own documentation project for Tomcat 3.3 and 4.0.
> The different thing about this project is that, i am going to port all of
> the tomcat documentation to XML Docbook format.
Not speaking officially, I'm not a committer: if you want to document
Tomcat, then go ahead and good luck!
Your focused work can do lots for the docs: you will probably end before
the "committee" decides the right format for Tomcat docs :)
Just a suggestion:
> Though i am not very good at docbook but i think i can cope. Once the
> documentation is complete, I will submit it to the main tomcat development
> team.
Don't wait till everything is ready; send your updates regularly to the
dev list, so folks can criticize your work and point possible mistakes.
That way, you can change course in a timely manner; otherwise you might
find at the end that a chapter is unnecessary and another one is missing
:)
Un saludo,
Alex.