- Users must use a `<file>.adoc#` prefix for all cross-reference links. This is _required_ to achieve working links in all 3 outputs: multi-page user manual, single-page user manual, and PDF. - The manual PDF is no longer themed, and no longer has the list of examples links in the TOC. - File names were changed from camelCased to snake_case to have a crystal clear 1-1 mapping between source to output. - Section reference verification is now handled by Asciidoctor verbose mode. - The single-page user manual has the same navigation as the multi-page manual for now. - [Common Asciidoctor extensions](https://github.com/gradle/dotorg-docs/tree/master/docs-asciidoctor-extensions) are now used by Gradle Guides and the User Manual, however, the the web assets (CSS, JS, etc) are not yet merged. These extensions are responsible for injecting the navigation and styles. The header/footer/navigation HTML can now be found under `subprojects/docs/src/main/resources`.