RFR: 8355223: Improve documentation on @IntrinsicCandidate [v3]

[Chen Liang]

> In offline discussion, we noted that the documentation on this annotation does not recommend minimizing the intrinsified section and moving whatever can be done in Java to Java; thus I prepared this documentation update, to shrink a "TLDR" essay to something concise for readers, such as pointing to that list at `vmIntrinsics.hpp` instead of "a list".

Chen Liang has updated the pull request incrementally with one additional commit since the last revision:

  Updates, thanks to John

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/24777/files
  - new: https://git.openjdk.org/jdk/pull/24777/files/e8adab3c..e2e1da5e

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=24777&range=02
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=24777&range=01-02

  Stats: 60 lines in 1 file changed: 40 ins; 10 del; 10 mod
  Patch: https://git.openjdk.org/jdk/pull/24777.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/24777/head:pull/24777

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