Please review: Issue: https://bugs.openjdk.java.net/browse/JDK-8222528 Webrev: http://cr.openjdk.java.net/~hannesw/8222528/webrev.00/ Javadoc now requires that headings be consistent with accessibility guidelines. Since h1 is usually the page heading user documentation headings should start with h2. Thanks, Hannes