JDK-8215307 : Pages do not have

  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 12
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2018-12-12
  • Updated: 2019-05-21
  • Resolved: 2019-02-21
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 13
13 b10Fixed
Related Reports
Duplicate :  
Relates :  
Relates :  
Description
The pages for types do not have a <h1> header. This is reported as an accessibility issue.

This file is a representative sample:
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Object.html

Here's the source at the beginning of main:

<!-- ======== START OF CLASS DATA ======== -->
<main role="main">
<div class="header">
<div class="subTitle"><span class="moduleLabelInType">Module</span>&nbsp;<a href="../../module-summary.html">java.base</a></div>
<div class="subTitle"><span class="packageLabelInType">Package</span>&nbsp;<a href="package-summary.html">java.lang</a></div>
<h2 title="Class Object" class="title">Class Object</h2>
</div>

https://dequeuniversity.com/rules/axe/3.0/page-has-heading-one?application=webdriverjs

There are 1415 instances on this in the ltest Axe report.

Comments
The trivial fix of hand-editing <h2> to <h1> causes a follow-up error of "out-of-order" headers, caused by <h3> without intervening <h2>
12-12-2018

This should probably be reconsidered in the context of a larger discussion about <h?> tags in general.
12-12-2018