JDK 9 RFR(m): 8177788 migrate collections docs into jdk doc-files

Mandy Chung mandy.chung at oracle.com
Thu Apr 6 00:54:53 UTC 2017


> On Apr 5, 2017, at 5:44 PM, Stuart Marks <stuart.marks at oracle.com> wrote:
> 
> Hi all,
> 
> Here's another step in the docs cleanup: migration of the collections technotes/guides into the JDK's javadoc doc-files. This is a webrev containing two changesets:
> 
> JDK-8177787 copy collections technotes/guides html files into jdk doc-files
> JDK-8177788 fix links, minor editing, add Java SE 9 changes to collections docs
> 
> The main way to reach these pages will now be a link from the java.util package documentation.
> 
> There are a bunch of places around the javadoc that point to the obsolete location of the collections docs. These are typically within sentences of the form "This class is a member of the Java Collections Framework." The next step will be to change all those links to point to the docs in their new location.
> 
> Here's the webrev:
> 
> http://cr.openjdk.java.net/~smarks/reviews/8177788/webrev.0/

Other than designfaq.html, these html files such as changes[3-9].html,
index.html, overview.html, and reference.html seem not worthing 
to be retained.

Since the links need to be fixed anyway, perhaps we should get rid
of those links instead unless it references some useful documents.

Mandy



More information about the core-libs-dev mailing list