On 22 December 2017 at 18:16, Steve Ebersole <st...@hibernate.org> wrote: > I wanted to get everyone's opinion about the api/spi/internal package > grouping we do in the aggregated Javadoc in regards to the per-module > javadocs. Adding this logic adds significant overhead to the process of > building the Javadoc, to the point where I am considering not performing > that grouping there. > > Thoughts?
For Hibernate Search we recently decided to not produce javadocs at all for "internal"; everything else is just documented as a single group. That cuts on the "need to know" complexity of end users. Advanced users who could have benefitted from knowing more about the internals will likely have sources. > > On Tue, Dec 12, 2017 at 11:37 AM Vlad Mihalcea <mihalcea.v...@gmail.com> > wrote: >> >> I tested it locally, and when publishing the jars to Maven local, the >> JavaDoc is now included. >> >> Don't know if there's anything to be done about it. >> >> Vlad >> >> On Mon, Dec 11, 2017 at 9:32 PM, Sanne Grinovero <sa...@hibernate.org> >> wrote: >> >> > +1 to merge it (if it works - which I didn't check) >> > >> > Some history can easily be found: >> > - >> > http://lists.jboss.org/pipermail/hibernate-dev/2017-January/015758.html >> > >> > Thanks, >> > Sanne >> > >> > >> > On 11 December 2017 at 15:24, Vlad Mihalcea <mihalcea.v...@gmail.com> >> > wrote: >> > > Hi, >> > > >> > > I've noticed this Pull Request which is valid and worth integrating: >> > > >> > > https://github.com/hibernate/hibernate-orm/pull/2078 >> > > >> > > Before I merge it, I wanted to make sure whether this change was >> > accidental >> > > or intentional. >> > > >> > > Was there any reason not to ship the JavaDoc jars along with the >> > > release >> > > artifacts and the sources jars as well? >> > > >> > > Thanks, >> > > Vlad >> > > _______________________________________________ >> > > hibernate-dev mailing list >> > > hibernate-dev@lists.jboss.org >> > > https://lists.jboss.org/mailman/listinfo/hibernate-dev >> > >> _______________________________________________ >> hibernate-dev mailing list >> hibernate-dev@lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/hibernate-dev _______________________________________________ hibernate-dev mailing list hibernate-dev@lists.jboss.org https://lists.jboss.org/mailman/listinfo/hibernate-dev
