[jfx19] RFR: 8286678: Fix mistakes in FX API docs [v3]

[Nir Lisker]

> Fixes the mistakes in the JBS ticket and some additional minor corrections.

Nir Lisker has refreshed the contents of this pull request, and previous commits have been removed. The incremental views will show differences compared to the previous content of the PR. The pull request contains one new commit since the last revision:

  Initial commit

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

Changes:
  - all: https://git.openjdk.org/jfx/pull/877/files
  - new: https://git.openjdk.org/jfx/pull/877/files/263061e3..5d0fbdea

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jfx&pr=877&range=02
 - incr: https://webrevs.openjdk.org/?repo=jfx&pr=877&range=01-02

  Stats: 7926 lines in 80 files changed: 6688 ins; 1116 del; 122 mod
  Patch: https://git.openjdk.org/jfx/pull/877.diff
  Fetch: git fetch https://git.openjdk.org/jfx pull/877/head:pull/877

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