[foreign-memaccess+abi] RFR: Update docs [v4]

[Maurizio Cimadamore]

> This patch updates the README of the foreign-memaccess+abi branch (which will soon become the new default branch for this repo).
> It also updates the various docs to reflect the latest API changes

Maurizio Cimadamore has updated the pull request incrementally with one additional commit since the last revision:

  Separated out new text into a subsection

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

Changes:
  - all: https://git.openjdk.java.net/panama-foreign/pull/688/files
  - new: https://git.openjdk.java.net/panama-foreign/pull/688/files/52689b87..339a964d

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=panama-foreign&pr=688&range=03
 - incr: https://webrevs.openjdk.java.net/?repo=panama-foreign&pr=688&range=02-03

  Stats: 5 lines in 1 file changed: 4 ins; 0 del; 1 mod
  Patch: https://git.openjdk.java.net/panama-foreign/pull/688.diff
  Fetch: git fetch https://git.openjdk.java.net/panama-foreign pull/688/head:pull/688

PR: https://git.openjdk.java.net/panama-foreign/pull/688