RFR: 8345836: Stable annotation documentation is incomplete

[Ioi Lam]

Please review this documentation update, authored by @rose00 and originally pushed to the Leyden repo in [this PR](https://github.com/openjdk/leyden/pull/26), where more comments can be found regarding this update.

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

Commit messages:
 - 8345836: stable annotation documentation is incomplete

Changes: https://git.openjdk.org/jdk/pull/26355/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=26355&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8345836
  Stats: 326 lines in 1 file changed: 280 ins; 12 del; 34 mod
  Patch: https://git.openjdk.org/jdk/pull/26355.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/26355/head:pull/26355

PR: https://git.openjdk.org/jdk/pull/26355