[jfx15] RFR: 8228570: Add various documentation clarifications [v2]

[Nir Lisker]

On Fri, 7 Aug 2020 13:37:28 GMT, Kevin Rushforth <kcr at openjdk.org> wrote:

>> Nir Lisker has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Corrected javadoc generation errors
>
> modules/javafx.graphics/src/main/java/javafx/scene/Node.java line 868:
> 
>> 867:      * clearing the map or overriding its values. These entries are not removed automatically if the node is
>> removed from the layout 868:      * manager, so unused entries can exist throughout the life of the node.
>> 869:      *
> 
> If we were in the habit of using `@apiNote` then that's probably where the note about layout managers using the node
> properties would go. Since we aren't, this seems fine.

I think that `@aipNote` is indeed better. Does it require a CSR?

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

PR: https://git.openjdk.java.net/jfx/pull/276