I took a stab at the javadoc descriptions for the modules modeled after what we discussed for the java.prefs module.
The webrev can be found at http://cr.openjdk.java.net/~lancea/8161965/ <http://cr.openjdk.java.net/~lancea/8161965/> Once we reach agreement, will a CCC be needed given this is really not a spec change? Best Lance > Begin forwarded message: > > From: Brian Burkhalter <brian.burkhal...@oracle.com> > Subject: Re: JDK 9 RFR of 8161402: Provide a javadoc description for > java.prefs module > Date: July 19, 2016 at 11:06:48 AM EDT > To: Core-Libs-Dev <core-libs-dev@openjdk.java.net> > > It seems to me it would be less work overall if there were only one single > issue to subsume adding the verbiage for all modules. There is only one > single line of verbiage for each such issue and having so many reviews go > around is a lot of noise. Then also if a CCC were required there would be > only one. As suggested, there should be consistency in the verbiage without > redundancy. A general template for the verbiage should be agreed upon first > before the existing issues continue to be addressed or collapsed into one > single issue. > > My $0.005. > > Brian <http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif>Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037 Oracle Java Engineering 1 Network Drive Burlington, MA 01803 lance.ander...@oracle.com <mailto:lance.ander...@oracle.com>
