RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

[Kevin Rushforth]

On Thu, 24 Jun 2021 01:53:53 GMT, Michael Strauß <mstrauss at openjdk.org> wrote:

>> * Expand the `Property.bind` and `Property.bindBidirectional` documentation
>> * Change the name of the formal parameter of `Property.bind` to "source" (currently, it is inconsistently named "observable", "rawObservable" or "newObservable")
>
> Michael Strauß has updated the pull request incrementally with one additional commit since the last revision:
> 
>   changes as per review

This seems like a reasonable fix. I'll review the docs in more detail soon. I think this can still be targeted for JavaFX 17. Since we are now in rampdown, if you would like to proceed with this for 17, you will need to retarget this PR to the `jfx17` branch instead of `master`.

If you do target this to `jfx17` you need to be careful not to sync from the latest `master` branch else you will pull in unwanted changes not intended for 17.

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

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