RFR: 8351565: Implement JEP 502: Stable Values (Preview) [v33]

[Jorn Vernee]

On Mon, 28 Apr 2025 11:29:46 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> wrote:

>> Yeah, that was what I was thinking too.
>
> Note - the JEP uses the word `content` (which has, I think, been "vetted"). So I believe it would be ok (and, preferrable) to leave it as is. Unless you are suggesting to also update the JEP?

I've been told by several native speakers that both "content" and "contents" work, but the latter is preferable. My personal view is that "contents" feels more natural. I think if it's updated here in the javadoc, then updating the JEP would also be a logical conclusion.

However, if the decision to use "content" comes from the JEP, then I'd say stick with that.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/23972#discussion_r2063708103