[amber-docs] RFR: Revise and restructure for the new web-page generator

[Mark Reinhold]

On Fri, 22 Oct 2021 19:18:05 GMT, Jim Laskey <jlaskey at openjdk.org> wrote:

>> 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
>
> site/guides/text-blocks-guide.md line 845:
> 
>> 843: is done for text blocks.
>> 844: 
>> 845: ### `String translateEscapes()`
> 
> &nbsp again

The ` `s that you see are tweaks to defend against poor line breaks in the table of contents at the top of the document. Without them then at normal width “New Escape Sequences” would break after “New,” and “`String translateEscapes()`” would break after “`String`”.

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

PR: https://git.openjdk.java.net/amber-docs/pull/10