RFR: JDK-8223358: Incorrect HTML structure in annotation pages

[Jonathan Gibbons]

On Wed, 29 Sep 2021 06:09:53 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

> As a sidenote: I also considered changing the nomenclature of the whole bunch of classes from the obsolete "annotation type" to "annotation interface", but I think that would have been an even bigger disruption in the code. If we want to do this I would prefer to do it as a separate task.

Generally, I think this is a *bad idea* and we should not do it.  We are stuck with the existing naming in the reflection interfaces (`java.lang.reflect.*` and `javax.lang.model.*`) where the `Type` terminology persists and will remain.  I think we have to accept that the "classes and interfaces" terminology is for user-facing text, and that we will have to live with the old-style terminology in code, just to keep the code consistent.

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

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