JDK-8199176 : Accessibility issues in java.base docs
  • Type: Bug
  • Component: core-libs
  • Affected Version: 11
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • Submitted: 2018-03-06
  • Updated: 2018-06-27
  • Resolved: 2018-04-02
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 11
11 b08Fixed
Related Reports
Relates :  
Relates :  
Relates :  
Description
1.The following docs don't have main landmarks. See https://www.w3.org/TR/WCAG20-TECHS/ARIA11.htm and all content should be contained in a landmark region.

docs/api/java.base/java/net/doc-files/net-properties.html
docs/api/java.base/java/util/doc-files/coll-overview.html
docs/api/java.base/java/util/doc-files/coll-reference.html
docs/api/java.base/java/util/doc-files/coll-index.html
docs/api/java.base/java/util/doc-files/coll-designfaq.html
docs/api/java.base/java/lang/doc-files/threadPrimitiveDeprecation.html
docs/api/java.base/java/lang/doc-files/ValueBased.html

2. Low contrast
docs/api/java.base/java/time/chrono/HijrahChronology.html	
<code>Locale</code>	Element has insufficient color contrast of 4.35 (foreground color: #4a6782- background color: #dddddd- font size: 10.5pt- font weight: bold). Expected contrast ratio of 4.5:1	html > body > [role="main"] > .contentContainer > .description > ul > li > .block > table > thead > tr > th:nth-child(3) > a > code


3. Heading order invalid
docs/api/java.base/java/time/temporal/package-summary.html    <h3>Fields and Units</h3>
docs/api/java.base/java/time/chrono/package-summary.html    <h3>Example</h3>
docs/api/java.base/java/time/zone/package-summary.html    <h3>Package specification</h3>
docs/api/java.base/java/time/package-summary.html    <h3>Dates and Times</h3>
docs/api/java.base/java/time/format/package-summary.html    <h3>Package specification</h3>
docs/api/java.base/java/lang/package-summary.html    <h3>Character Encodings</h3>
docs/api/java.base/java/nio/file/package-summary.html    <h3><a id="links">Symbolic Links</a></h3>

4. Broken link <a href="#feature">feature version number</a>
http://hg.openjdk.java.net/jdk/jdk/file/af37d9997bd6/src/java.base/share/classes/java/lang/Runtime.java#l1192

Comments
A future solution that correctly generates the appropriate and consistent headers is desirable. An enhancement to the javadoc tool may be necessary, please refer to JDK-8199895 for more details.
04-04-2018

Refer to the linked issues (JDK-8199892, JDK-8199893, JDK-8199895), item 1 and 2 are javadoc tool issues, and 3 could use an enhancement. For this issue therefore, we'll fix item 3 and 4.
20-03-2018

The doc-files/* should be upgraded to html5 in the <!DOCTYPE...> and other fixes as requested.
07-03-2018