RFR 8161965 -> Fwd: JDK 9 RFR of 8161402: Provide a javadoc description for java.prefs module

[Lance Andersen]

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.burkhalter at 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 at 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.Andersen at oracle.com <mailto:Lance.Andersen at oracle.com>