[foreign-jextract] RFR: Refresh panama documents to reflect API changes [v2]

[Maurizio Cimadamore]

> This patch tweaks the foreign memory access/linker documents to reflect the various changes in the API. Most notable changes are:
> 
> * The name of many static factories (e.g. layouts) has changed
> * We dropped `MemorySegment::allocate` variants which do not accept a scope
> 
> I've also dropped the html version of said documents - since I believe the github rendering to be good enough (and, we refer to the github pages hosting these docs from other places anyway).

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

  Fix minor typos in the foreign memaccess doc

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

Changes:
  - all: https://git.openjdk.java.net/panama-foreign/pull/535/files
  - new: https://git.openjdk.java.net/panama-foreign/pull/535/files/7b440e4d..96f44d59

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=panama-foreign&pr=535&range=01
 - incr: https://webrevs.openjdk.java.net/?repo=panama-foreign&pr=535&range=00-01

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

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