Summary

We need to clarify the status of the links to external resources in the documentation.

Problem

In the documentation of the java.desktop module we have references to the examples, tutorials, guides, etc. Such references may be considered by the users as part of the specification.

Specification

src/java.desktop/share/classes/module-info.java

  * Defines the AWT and Swing user interface toolkits, plus APIs for
  * accessibility, audio, imaging, printing, and JavaBeans.
+ * <p>
+ * The documentation in this module includes links to external overviews,
+ * tutorials, examples, guides, media format specifications, and other similar
+ * documentation. These links are meant to be informative to the reader and
+ * nothing more. Information at these external resources, no matter the hosting
+ * or the author, is not part of Java Platform API specification unless
+ * explicitly stated to be so.

http://cr.openjdk.java.net/~serb/8219578/webrev.01/src/java.desktop/share/classes/module-info.java.udiff.html