RFR: 8308645: Javadoc of FFM API needs to be refreshed [v4]

[Per Minborg]

On Thu, 1 Jun 2023 21:47:23 GMT, Jorn Vernee <jvernee at openjdk.org> wrote:

>> I think the term is used pretty much all over the javadoc (not just FFM's) - e.g. look for this preamble:
>> 
>>  * <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>,
>>  * immutable and thread-safe
>>  ```
>
> Right, I guess I'm asking: can/should we do better? ;) It might be nice to define the term once and for all for the entire JDK, similar to how 'reachability' also has a central definition. (and then add a link from here).
> 
> But, arguably, that seems like too much scope creep for this PR, so let's save it for a potential followup.

I think there is something we could start off from: https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/annotations/ThreadSafe.html

This could be made under a separate issue.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/14098#discussion_r1214060977