Improve local development docs
Closes
MODIFY
docs/modules/project/nav.adoc
docs/modules/project/nav.adoc
* Development
** xref:project-layout.adoc[]
-** xref:build.adoc[]
+** xref:local-development.adoc[]
** xref:ide.adoc[]
** xref:continuous-integration.adoc[]

DELETE
docs/modules/project/pages/build.adoc
-= Build the Project
-
-Invoke Gradle on this project using the `gradlew` command (i.e., the Gradle Wrapper).
-
-TIP: We strongly recommend that you use Gradle via the https://www.timroes.de/2013/09/12/speed-up-gradle[Gradle daemon].
-
-To clone the project, compile the source and build the artifacts (i.e., jars) locally, run:
-
- $ git clone https://github.com/asciidoctor/asciidoctorj
- cd asciidoctorj
- ./gradlew assemble
-
-You can find the built artifacts in the [path]_asciidoctorj-*/build/libs_ folders.
-
-To execute tests when running the build, use:
-
- $ ./gradlew build
-
-To only execute the tests, run:
-
- $ ./gradlew check
-
-You can also run tests for a single module:
-
- $ cd asciidoctorj-core
- ../gradlew check
-
-To run a single test in the asciidoctorj-core subproject, use:
-
- $ ../gradlew -Dsingle.test=NameOfTestClass test
-
-To create the distribution, run:
-
- $ ./gradlew distZip
-
-You can find the distribution in the [path]_asciidoctorj-distribution/build/distributions_ folder.

ADD
docs/modules/project/pages/local-development.adoc
+= Local Development
+
+Project is fully handled using https://gradle.org/[Gradle].
+That includes from dependency management, to building, testing and releasing.
+
+While IDE integration is the most common workflow, all tasks can be run using the `gradlew` command (i.e., the Gradle Wrapper).
+
+TIP: We strongly recommend that you use Gradle via the https://www.timroes.de/2013/09/12/speed-up-gradle[Gradle daemon].
+
+== Build the artifacts
+
+To clone the project, compile the source and build the artifacts (i.e., jars) locally, run:
+
+ $ git clone https://github.com/asciidoctor/asciidoctorj
+ $ cd asciidoctorj
+ $ ./gradlew assemble
+
+Then, you can find the built artifacts in the [path]_asciidoctorj-*/build/libs_ folders.
+
+== Test
+
+To execute tests when running the build, use:
+
+ $ ./gradlew build
+
+To only execute the tests, run:
+
+ $ ./gradlew check
+
+You can also run tests for a single module:
+
+ $ cd asciidoctorj-core
+ ../gradlew check
+
+To run a single test in the asciidoctorj-core subproject, use:
+
+ $ ../gradlew -Dsingle.test=NameOfTestClass test
+
+== Create distribution
+
+To create the distribution containing all files, run:
+
+ $ ./gradlew distZip
+
+You can find the distribution in the [path]_asciidoctorj-distribution/build/distributions_ folder.
+
+== Locally install the artifacts
+
+If you need to install the artifacts in local Maven repository, for example to be used as dependency for another project.
+
+ $ ./gradlew publishToMavenLocal
+
+Artifacts will be at [path]_~/.m2/repository/org/asciidoctor/asciidoctorj_.

MODIFY
docs/modules/project/pages/project-layout.adoc
docs/modules/project/pages/project-layout.adoc
@@ -34,6 +34,9 @@ asciidoctorj-test-support::
asciidoctorj-wildfly-integration-test::
Wildfly integration tests.
+asciidoctorj-springboot-integration-test::
+ Spring Boot example app and integration tests.
+
The Gradle build is partitioned into the following files:
....

MODIFY
gradle/signing.gradle
gradle/signing.gradle
def hasSigningKey = project.hasProperty("signing.keyId") || project.findProperty("signingKey")
+
if (hasSigningKey && !project.hasProperty('skip.signing')) {
apply plugin: 'signing'
sign(project)
}
+
void sign(Project project) {
project.signing {
required { project.gradle.taskGraph.hasTask("required") }

Improve local development docs

Closes #835