On 14/07/2015 08:36, Michael Dürig wrote: > > ... > What do people think about leveraging this mechanism for > http://jackrabbit.apache.org/oak/docs/? Currently we only host > Javadocs for the latest release. Should we start linking to > http://www.javadoc.io/ for older releases? Should we stop hosting > Javadocs ourselves entirely in favour of http://www.javadoc.io/? Or > should we not change anything at all?
I think the fact we don't have 1.2 and 1.0 javadocs available is bad. Right now we host the 1.3.x which I generates at every 1.3 release with a bit of "hacking" around with checkins, site and site-deploy. What we could do, IMO is: - hosting always and only -SNAPSHOT - linking 1.3, 1,2 and 1.0 to javadoc.io. - updating our website linking the latest released version. What I don't like of javadoc.io is the fact that you have to get to the maven artifact for the javadoc and it doesn't have something like jackrabbit-oak/index.html all the javadocs like in http://jackrabbit.apache.org/oak/docs/apidocs/index.html. Davide
