This is like optimizing code ;) don't do it unless you measure that what you have now is a problem. I would not find seeing some apache graphical branding but that's it. I find the Google example and it's mix of font sizes ugly as sin. It's all subjective of course. This could end up a discussion about where to put curly braces...
On Mar 9, 2012, at 6:13, Simone Tripodi <simonetrip...@apache.org> wrote: > Salut Manu, > > I can do something, it is a matter of implementing a doclet for > javadoc - the Maven plugin already supports it, unfortunately I don't > have so much spare time to follow all these activities ATM :( > > On 2010/2011 I helped Google Doclava[1] team on releasing the Doclava > Doclet to Mvn central repo, it looks like the Google Guice one[2]. > > I think forking a Doclet we all like to start implementing our own > would be a good starting point. > > All the best, > -Simo > > [1] http://code.google.com/p/doclava/ > [2] http://google-guice.googlecode.com/git/javadoc/packages.html > > http://people.apache.org/~simonetripodi/ > http://simonetripodi.livejournal.com/ > http://twitter.com/simonetripodi > http://www.99soft.org/ > > > > On Fri, Mar 9, 2012 at 11:21 AM, 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 > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org
