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

Mon Aug 10 10:45:03 UTC 2020

On Fri, 7 Aug 2020 14:37:48 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
>
> I left a few formatting comments and a substantive one on the clarification of the transform order, which I recommend
> to defer to 16.

@kevinrushforth @arapte Can you give your input on the changes to the methods with an extractor in `FXCollections` that
I mentioned in the 3rd bullet point of this PR?

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

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