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 2342f5f48a
commit a5a4960859
6 changed files with 3 additions and 3 deletions

View File

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

View File

@ -7873,4 +7873,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

@ -8494,7 +8494,7 @@ Spring MVC Test's own tests include
https://github.com/spring-projects/spring-framework/tree/master/spring-test/src/test/java/org/springframework/test/web/client/samples[example
tests] of client-side REST tests.
include::testing-webtestclient.adoc[leveloffset=+2]
include::testing/testing-webtestclient.adoc[leveloffset=+2]