--- On Wed, 10/22/08, Philip Luppens wrote:
> - Documentation: no more (example) documentation in the
> Javadocs so non-committers can make changes in the wiki.

I'd augment this a bit

I'd really like all the examples to be in source control and have associated 
tests, and I'm willing to spend some effort to do that (starting at the 
beginning of 2009; this year is packed).

Yes, that means that either non-committers can't write "official" examples, 
although un-official examples would be supported--as they are now--on the wiki. 
I don't see a whole lot of non-developer-driven examples, however, although 
they exist.

We're still hammered by documentation (2.0 v. 2.1 issues) and I'd *really* like 
to see two Confluence spaces for that. Yeah, I know 2.1 is (in theory) rolling 
soon, but not everyone may upgrade right away. I'm also willing to put some 
work into that.

I agree with one of the initial statements that the documentation could be 
better organized, although I think that could be handled with some aggregate 
pages that organize existing documentation in different (hopefully better) ways.

I also like the tags being documented through the annotations, but either the 
annotations or the processing tool should include some information regarding 
when attributes were introduced etc. 

Dave


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to