Hi Rob!
[quotes in no particular order]
> I would've thought a thread about docs would be concerned with what docs to
> create, what docs will glue them together, maybe an image on the doc
> homepage with a map showing what order you can read them, etc.
Just start with it. When you have something, post it as a patch and they
(Tomcat committers) will have to decide.
IMHO, it would be better to create a tomcat-doc list and let people
debate all these matters to death, and then perhaps do something. No
need to have everything pinned up beforehand -- besides, it seems
impossible to find a consensus.
> As far as Anakia is concerned, it's proven (within Jakarta), it looks a lot
> like XHTML, there's resident expertise, and TC 4 is already using it. Of
> course I am *all for* debate, discussion, etc. but in lieu of all of the
> above, why continue dicussing it? What's *wrong*?
You are right, there's nothing wrong with the dozen or so proposals to
format documentation -- except there are so many.
> All of this other bunk is essentially worthless to me. Tell me what docs to
> create, what's wrong with the ones I'm rewriting or replacing (if that's the
> case), and I'll do it in text or HTML. Everyone who wants to talk about how
> to render it can deal with it when I'm done - although I have a feeling they
> won't be the ones taking the time to port my output over to whatever format
> they deem reasonable.
Use your imagination. What docs would you like to have?
> So please, can we at least START some discussion about the contents of the
> docs other than "we need to write them" ? There's a lot of work to be done,
> and I would imagine that someone knows where a good place is to start.
If you don't know where to start, then perhaps this particular task is
not for you. No offense meant, just that someone must set off with a
clear mind.
Un saludo,
Alex.
