JEP 224: HTML5 Javadoc

OwnerBhavesh Patel
TypeFeature
ScopeJDK
StatusClosed / Delivered
Release9
Componenttools / javadoc(tool)
Discussionjavadoc dash dev at openjdk dot java dot net
EffortM
DurationM
Reviewed byJonathan Gibbons
Endorsed byBrian Goetz
Created2014/06/05 20:00
Updated2018/04/13 08:16
Issue8046068

Summary

Enhance the javadoc tool to generate HTML5 markup.

Goals

Provide an option to the standard doclet to request either HTML 4 or HTML5 output. The HTML5 markup is semantic, i.e., clearly separating meaning from style and content. The parts of the pages generated by the standard doclet using HTML5 markup satisfy accessibility requirements.

Non-Goals

It is a not a goal to replace the current three-frame/no-frame structure of the generated HTML pages; that may be the subject of a future JEP.

It is not a goal to mandate the use of HTML5 in documentation comments, nor is it a goal to provide the ability to convert documentation comments written using HTML 4 to HTML5.

Motivation

In JDK 8 and older releases, the standard doclet generated pages in HTML 4.01, which is an old standard, and not not provide support for satisfying accessibility requirements.
HTML5 is the latest standard for HTML. HTML5 increases the semantic value of web pages and makes it easier to create accessible web pages.

Description

Testing

Tests are provided to ensure that:

The lack of automated tools to test accessibility hampers comprehensive accessibility testing. A representative sample of different types of pages can checked using online web-based tools.