RFR: 8341064: Define anchor point and index term for "wrapper classes" [v3]

[Joe Darcy]

On Sun, 29 Sep 2024 18:08:10 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> Agree; I have recommedned consolidating id property into h2 without an extra a tag.
>
> `<dfn>` is a semantic tag to indicate the defining instance of a term. It may be used by search engines, to improve their results.   When `<dfn>` is used as intended, it may be reasonable and convenient to put an `id` on the tag, to provide a link target for elsewhere in the documentation. It may also be convenient to add `id` to other locations, especially headers, but note that `javadoc` now does that automatically.
> 
> The usage of `<a name="...">` is a legacy usage from HTML 4, before the improved rules for `id` in HTML 5.  It would be a reasonable cleanup to move away from such tags, putting an equivalent `id` on either a replacement tag (such as `<span>`) or on an appropriate nearby tag.

Thanks for the HTML tip; will add an id to the dfn tag.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/21215#discussion_r1780318858