RFR: 8345836: stable annotation documentation is incomplete [v6]

[Vladimir Ivanov]

On Thu, 9 Jan 2025 07:29:05 GMT, John R Rose <jrose at openjdk.org> wrote:

>> The javadoc for jdk.internal.vm.annotation.Stable is incomplete.
>> 
>> The existing documentation gives an over-simple user model,
>> and does not explain how it is implemented.
>> Proposed new documentation will detail how the annotation
>> is implemented, and how it may be used correctly.
>> 
>> The improved documentation will makes it easier for JDK programmers
>> to use the annotation more aggressively, and more confidently.
>> 
>> This is a first cut.  Please comment…
>
> John R Rose has updated the pull request incrementally with one additional commit since the last revision:
> 
>   remove stray word

Looks good.

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

Marked as reviewed by vlivanov (Committer).

PR Review: https://git.openjdk.org/leyden/pull/26#pullrequestreview-2540667322