Just wanted to dredge up this old thread concerning documentation to
find out what status it has now after the last conversation.
I had problems today finding some documentation on the war plugin.
Pretty standard stuff but I couldn't even find the plugins documentation
start page in the left-hand menu, rather I found it on the home page
(where I happened NOT to be to start with) in the text. I think this is
a symptom of the extensive nature of the maven docs, but still it's
pretty fundamental.
Secondly the comments functionality or the link to the wiki is a pretty
urgent requirement for me, and I think I'm a typical user.
I noticed recently that the www.springframework.org website uses drupal
for its comments mechanism and that they have currently disabled it
pending an upgrade to prevent comment-spamming!
Having said that, I know it would be good if I could contribute but time
constraints prevent that, sorry. I'm just hoping that re-iterating my
comments will help get this issue further up the list of priorities,
which I think would be beneficial for everybody.
Regards
Adam
Sebastien Arbogast wrote:
2 thoughts about what you wrote Vincent:
I totally agree on the fact that a few people have to write the core
of the documentation before any community effort can be considered.
But at some point, a PDF and an errata page is not the best way to
create a community effort in order to keep this book up-to-date and
more accessible.
This leads me to the second point: Maven's wiki doesn't work for the
very same reason Cocoon one didn't, for the very same reason I've
never seen one good documentation effort based solely on a WIKI: no
structure! And that's exactly what your book could be useful as: some
sort of a spinal cord on which other content can be aggregated and
accumulated over time, and sometimes assimilated on a rewrite.
Moreover, I don't believe in Wikis at all because instead of adding
some information, it just replaces it, even if it keeps some kind of
version tracking behind the scenes.
IMHO, Maven documentation should look like that:
http://drupal.org/handbooks
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
