RFR: JDK-8275518: accessibility issue in Inet6Address docs

Jonathan Gibbons jjg at openjdk.java.net
Wed Oct 27 16:10:13 UTC 2021


On Tue, 19 Oct 2021 13:50:20 GMT, Ludvig Janiuk <duke at openjdk.java.net> wrote:

> Single-row table was being used for visual effect, but a description list seems more appropriate.

OK, but ...

While the basic translation from a single-row table to a definition list looks good, it's not clear you still need the `style` attribute. Also, explicit use of `<b>` and `<i>` is discouraged for accessibility reasons; if you need any tags to adjust the font here, it's better to use semantic equivalents like `<strong>` and `<em>` (emphasis). But even better to reduce unnecessary stylistic changes and rely on the default settings (in this case for `<dl>`) in the stylesheet.

-------------

Marked as reviewed by jjg (Reviewer).

PR: https://git.openjdk.java.net/jdk/pull/6010


More information about the net-dev mailing list