[jfx20] RFR: 8290863: Update the documentation of Virtualized controls to include the best practice of not using Nodes directly in the item list [v3]

[Nir Lisker]

On Tue, 24 Jan 2023 09:59:48 GMT, Ajit Ghaisas <aghaisas at openjdk.org> wrote:

>> modules/javafx.controls/src/main/java/javafx/scene/control/ListView.java line 152:
>> 
>>> 150:  * <h3>Warning: Nodes should not be inserted directly into the items list</h3>
>>> 151:  * ListView allows for the items list to contain elements of any type, including
>>> 152:  * {@link Node} instances. Putting nodes into
>> 
>> `Node` is already linked above so there's no need for it, but it's fine to leave as is.
>
> The first occurrence of `{@link Node}` is on line 152. I have kept the first occurrence and replaced others with `{@code Node}`

It's linked in the type hierarchy, but I'm fine with keeping an inline link.

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

PR: https://git.openjdk.org/jfx/pull/995