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