Do these reports in Maven provide a way of specifying a custom template? That would be preferable, since the maven default sucks.
On 11/15/05, Stephen Colebourne <[EMAIL PROTECTED]> wrote: > I spent some of the weekend fine tuning some improvements to the maven > documentation. I'd like to propose that other components consider the > same ideas. > > 1) Improving cvs-usage: > Maven default: > http://jakarta.apache.org/commons/digester/cvs-usage.html > Improved version: > http://jakarta.apache.org/commons/io/cvs-usage.html > > This provides much more info. > > 2) Improved issue-tracking: > Maven default: > http://jakarta.apache.org/commons/cli/issue-tracking.html > Improved version: > http://jakarta.apache.org/commons/io/issue-tracking.html > > Again, this provides much more info and hopefully improves reporting. > > 3) Including three sections on the home page - Documentation, Releases, > Support, example: > http://jakarta.apache.org/commons/io/ > > These provide the links to the improved pages, and also stress the [xxx] > convention for mailing lists and bugs. > > 4) Breaking the left navigation into Commons Xxx and Development menus, > example: > http://jakarta.apache.org/commons/io/ > > This separates the needs of most users from the needs of those who get > much more involved. > > 5) Javadoc directories: > The latest svn docs: > http://jakarta.apache.org/commons/io/apidocs/index.html > Version 1.0: > http://jakarta.apache.org/commons/io/api-1.0/index.html > Version 1.1: > http://jakarta.apache.org/commons/io/api-1.1/index.html > The latest release (a unix link to api-1.1): > http://jakarta.apache.org/commons/io/api-release/index.html > > This is the current best fit with maven, as maven can and will freely > overwrite the apidocs directory. Thus the idea is that when you do a > release, you copy the docs to the named directory manually. > > > > I'm not forcing anybody into anything :-), but I think these do provide > benefits to our users if we can share them across more commons > components. I would like us to try and agree on one naming convention > for the javadocs if at all possible. > > Currently these changes are implemented on [collections] and [io], and > are on their way (all or in part) in [validator] & [beanutils]. > > Stephen > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > > -- http://www.multitask.com.au/people/dion/ "You are going to let the fear of poverty govern your life and your reward will be that you will eat, but you will not live." - George Bernard Shaw --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
