Do not generate reference docs for include-files

Prior to this commit, the Asciidoctor Gradle tasks generated top-level
HTML and PDF documents for AsciiDoc files that are included in other
top-level documents. This causes slower builds and results in each
include-file being published twice:

1) inline in the including document (as intended)
2) as a top-level document but missing surrounding context (unintended)

The reason these include-files are generated as top-level documents is
that the asciidoctor and asciidoctorPdf Gradle tasks are configured to
use '*.adoc' as the input source files.

This commit addresses this issue by moving the following include-files
to new subdirectories. Locating the include-files in the subdirectories
causes them to be ignored in the '*.adoc' pattern used to identify
input source files.

- data-access-appendix.adoc -> data-access/data-access-appendix.adoc
- integration-appendix.adoc -> integration/integration-appendix.adoc
- testing-webtestclient.adoc -> testing/testing-webtestclient.adoc

Closes gh-25783
This commit is contained in:
Sam Brannen 2020-09-19 14:54:27 +02:00
parent 2a74f20c99
commit 87399aedf7
6 changed files with 3 additions and 3 deletions

View File

@ -9022,4 +9022,4 @@ within Web services.
include::data-access-appendix.adoc[leveloffset=+1]
include::data-access/data-access-appendix.adoc[leveloffset=+1]

View File

@ -6744,4 +6744,4 @@ directly through the backing cache (when configuring it) or through its native A
include::integration-appendix.adoc[leveloffset=+1]
include::integration/integration-appendix.adoc[leveloffset=+1]

View File

@ -6488,7 +6488,7 @@ of `AbstractTestNGSpringContextTests` for an example of how to instrument your t
include::testing-webtestclient.adoc[leveloffset=+2]
include::testing/testing-webtestclient.adoc[leveloffset=+2]