Revise and restructure for the new web-page generator

[mbreinhold]

Please review these changes to revise and restructure the amber-docs repository for use with the new web-page generator for openjdk.java.net.

That generator is presently defined in https://github.com/mbreinhold/ojweb-generate, which will shortly be moved over to the OpenJDK organization. Please see the README.md file in that repository for instructions on how to use it.

I’ve tried to keep content changes to a minimum, primarily adjusting minor things such as heading levels and code examples for better rendering.

You can preview the output here: https://openjdk.java.net/_test/amber/

For easy reviewing, there’s also a map of the entire subtree: https://openjdk.java.net/_test/amber/_map

---

Progress

• Change must not contain extraneous whitespace

Reviewers

• Brian Goetz (@briangoetz - Reviewer) ⚠️ Review applies to 0e0ab88
• Jim Laskey (@JimLaskey - Committer) ⚠️ Review applies to 0e0ab88

Reviewing

Using git

Checkout this PR locally:
$ git fetch https://git.openjdk.java.net/amber-docs pull/10/head:pull/10
$ git checkout pull/10

Update a local copy of the PR:
$ git checkout pull/10
$ git pull https://git.openjdk.java.net/amber-docs pull/10/head

Using Skara CLI tools

Checkout this PR locally:
$ git pr checkout 10

View PR using the GUI difftool:
$ git pr show -t 10

Using diff file

Download this PR as a diff file:
https://git.openjdk.java.net/amber-docs/pull/10.diff

[bridgekeeper]

👋 Welcome back mr! A progress list of the required criteria for merging this PR into master will be added to the body of your pull request. There are additional pull request commands available for use with this pull request.

[openjdk]

@mbreinhold This change now passes all automated pre-integration checks.

After integration, the commit message for the final commit will be:

Revise and restructure for the new web-page generator

Reviewed-by: briangoetz, jlaskey

You can use pull request commands such as /summary, /contributor and /issue to adjust it as needed.

At the time when this comment was updated there had been no new commits pushed to the master branch. If another commit should be pushed before you perform the /integrate command, your PR will be automatically rebased. If you prefer to avoid any potential automatic rebasing, please check the documentation for the /integrate command for further details.

➡️ To integrate this PR with the above commit message to the master branch, type /integrate in a new comment.

[mlbridge]

Webrevs

• 00: Full (b198f1b6)