(apologies in advance for the tone, I'm a happy person =)
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*?
I dunno who said it, but a long time ago there's a nice quote I heard in
English class, "The purity of a revolution lasts for about two weeks." It
explains what happens each time we talk about docs, a nice(r) admin UI, etc.
It seems like people are more interested in talking about what projects to
create, what tools to use, etc. when I *still* haven't read any comments
about *THE ACTUAL DOCUMENTATION* aside from "TOMCAT SUCKS!" and everyone's
agreement that the docs are in need of repair... Not a lot of
groundbreaking realizations left to make on those two points.
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.
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.
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.
- r
p.s. I thought of another one, "Too many chefs, not enough doc writers" ;)
