This is pretty subjective stuff. Personally I like the stock Java 7 best of all (java 6, java 7 "fix").
Gary On Mar 9, 2012, at 5:22, Emmanuel Bourg <ebo...@apache.org> wrote: > Hi all, > > I noticed that Commons Math 3.0 has been released with the new Javadoc > template introduced with Java 7 [1]. While this template looks more polished > at first glance, it's actually less readable than the old one for a variety > of reasons (changes in alignment, lack of indentation and emphasis). This led > me to publish some time ago a GreaseMonkey script that restore important > aspects of the old template [2]. > > I'm pondering if we could agree on a Javadoc template, derived from the one > in Java 7 and with an improved readability, that would be applied to all > Commons components. The visual aspect of this template could also be adapted > to the Apache branding, for example by replacing the blue gradient with a > purple/violet gradient referring to the Apache feather. > > The Hibernate project uses a custom Javadoc template and it looks pretty good > [3]. > > I haven't investigated how this could be implemented with Maven and if it's > possible to tweak the template in the parent pom. If anyone knows how it > works, please speak up! If it works well we could even share it at the ASF > level. > > Emmanuel Bourg > > > [1] http://docs.oracle.com/javase/7/docs/api > [2] http://userscripts.org/scripts/show/108797 > [3] http://docs.jboss.org/hibernate/core/3.6/javadocs > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org
