Antora docs improvements (#723)

From review asciidoctor/docs.asciidoctor.org#66 (comment)

docs/antora.yml

@@ -14,10 +14,10 @@ asciidoc:
     asciidoctor-maven-plugin-name: Asciidoctor Maven Plugin
     asciidoctor-maven-plugin-url: https://github.com/asciidoctor/asciidoctor-maven-plugin
     asciidoctor-url: https://asciidoctor.org
-    asciidoctorj-epub-name: Asciidoctorj EPUB3
+    asciidoctorj-epub-name: AsciidoctorJ EPUB3
     asciidoctorj-epub-url: https://github.com/asciidoctor/asciidoctorj-epub3
     asciidoctorj-name: AsciidoctorJ
-    asciidoctorj-pdf-name: Asciidoctorj PDF
+    asciidoctorj-pdf-name: AsciidoctorJ PDF
     asciidoctorj-pdf-url: https://github.com/asciidoctor/asciidoctorj-pdf
     asciidoctorj-url: https://github.com/asciidoctor/asciidoctorj
     asciidoctorjs-name: Asciidoctor.js

docs/modules/ROOT/nav.adoc

@@ -1,18 +1,17 @@
-* xref:index.adoc[]
 * xref:compatibility.adoc[]
 * xref:quick-start.adoc[]
 * xref:common-task-configuration.adoc[]
-* xref:asciidoctorj-base-plugin.adoc[]
-* xref:asciidoctorj-plugin.adoc[]
-* xref:asciidoctorj-pdf-plugin.adoc[]
-* xref:asciidoctorj-epub-plugin.adoc[]
-* xref:asciidoctorj-revealjs-plugin.adoc[]
+* Plugins
+** xref:asciidoctorj-base-plugin.adoc[]
+** xref:asciidoctorj-plugin.adoc[]
+** xref:asciidoctorj-pdf-plugin.adoc[]
+** xref:asciidoctorj-epub-plugin.adoc[]
+** xref:asciidoctorj-revealjs-plugin.adoc[]
+** xref:asciidoctorj-gems-plugin.adoc[]
+** xref:asciidoctoreditorconfig-plugin.adoc[]
 // * xref:asciidoctorj-leanpub-plugin.adoc[]
-* xref:asciidoctorj-gems-plugin.adoc[]
 * xref:asciidoctor-diagram.adoc[]
 // * xref:kindlegen-plugin.adoc[]
 * xref:asciidoctorj-custom-extensions.adoc[]
-* xref:asciidoctorjs-plugin.adoc[]
-* xref:asciidoctoreditorconfig-plugin.adoc[]
 * xref:docinfo.adoc[]
 * xref:upgrading.adoc[]

docs/modules/ROOT/pages/asciidoctoreditorconfig-plugin.adoc

@@ -1,4 +1,4 @@
-= The Asciidoctor Editor Config Plugin
+= Asciidoctor Editor Config Plugin
 
 [source,groovy,role="primary"]
 [subs=attributes+]

docs/modules/ROOT/pages/asciidoctorj-base-plugin.adoc

@@ -1,6 +1,6 @@
 = AsciidoctorJ Base Plugin
 
-This plugin is automatically applied by all AsciidoctorJ-based plugins.
+This plugin is automatically applied by all {asciidoctorj-name}-based plugins.
 
 Adds an extension for configuring which version of {asciidoctorj-name} and various other {asciidoctorj-name} backends.
 

docs/modules/ROOT/pages/compatibility.adoc

@@ -1,4 +1,4 @@
 = Compatibility
 
-This collection of plugins requires at least Gradle 4.9, JDK 11.0 and AsciidoctorJ 2.0.0 to run.
+This collection of plugins requires at least Gradle 4.9, JDK 11.0 and {asciidoctorj-name} 2.0.0 to run.
 If you need prior Gradle, JDK or {asciidoctorj-name} support please use a plugin from the 1.5.x or 1.6.x release series.

docs/modules/appendices/nav.adoc

@@ -1,4 +1,5 @@
 * Appendices
+** xref:asciidoctorjs-plugin.adoc[]
 ** xref:tips-and-tricks.adoc[]
 ** xref:known-limitations.adoc[]
 ** xref:hacking.adoc[]

docs/modules/ROOT/pages/asciidoctorjs-plugin.adoc → docs/modules/appendices/pages/asciidoctorjs-plugin.adoc

@@ -1,4 +1,4 @@
-= Working with Asciidoctor.js instead
+= Working with Asciidoctor.js
 
 Instead of {asciidoctorj-name}, {asciidoctorjs-url}[{asciidoctorjs-name}] can be used as a rendering engine from 3.0.