Polishing

Author: sbrannen

documentation/README.md

@@ -5,17 +5,21 @@ This subproject contains the AsciiDoc sources for the JUnit 5 User Guide.
 ## Structure
 
 - `src/docs/asciidoc`: AsciiDoc files
-- `src/test/java`: Test source code that can be included in the AsciiDoc files
-- `src/main/java`: Example source code that can be included in the AsciiDoc files
+- `src/test/java`: Java test source code that can be included in the AsciiDoc files
+- `src/test/kotlin`: Kotlin test source code that can be included in the AsciiDoc files
+- `src/test/resources`: Classpath resources that can be included in the AsciiDoc files or
+  used in tests
 
 ## Usage
 
 ### Generate AsciiDoc
 
-On linux, `graphviz` package providing `/usr/bin/dot` needs to be installed.
+This following Gradle command generates the HTML version of the User Guide as
+`build/asciidoc/index.html`.
 
 ```
-gradle asciidoctor
+gradlew asciidoctor
 ```
 
-This task generates HTML files into `build/asciidoc`.
+On Linux operating systems, the `graphviz` package providing `/usr/bin/dot` must be
+installed in order to generate the User Guide.