On Thu, 1 Jun 2023 21:47:23 GMT, Jorn Vernee <jver...@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