lol, totally agreed! indeed I am a fan of Doclava and try to use it as much as I, where possible, can :P
I would just suggest the same I suggested for checkstyle: lets define a common basis, the actual one should work as you proposed, and let components use what doclet they prefer (OTOH I wouldn't suggest that for the public site) @Manu: AFAIK (I could be wrong here) even for applying different CSS we have to create a small doclet with resources only - please keep me in the loop because if it is just twaking the css, would be much easier and I can provide more help. All the best, -Simo http://people.apache.org/~simonetripodi/ http://simonetripodi.livejournal.com/ http://twitter.com/simonetripodi http://www.99soft.org/ On Fri, Mar 9, 2012 at 12:33 PM, Gary Gregory <garydgreg...@gmail.com> wrote: > 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 > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org
