RFR: 8342566: Improve javadoc of java.lang.annotation.ElementType

[Kevin Bourrillion]

On Mon, 14 Oct 2024 20:31:51 GMT, Kevin Bourrillion <duke at openjdk.org> wrote:

> 8342566: Improve javadoc of java.lang.annotation.ElementType

Thanks so much Chen! I'm interested in your general thoughts: does it make sense where I have currently "drawn the line", as far as what information belongs in here and what doesn't? I think my goal is to basically answer ~all "where will I be able to put this annotation?" questions without forcing readers to try to read JLS - at least to the extent that those answers may influence which ElementTypes the user includes in their @Target.

The class javadoc is basically a ground-up rewrite, so the fact that it is broken into red/green diff blocks is not going to be too helpful (sorry).

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

PR Review: https://git.openjdk.org/jdk/pull/21506#pullrequestreview-2369893862
PR Comment: https://git.openjdk.org/jdk/pull/21506#issuecomment-2412217852