[groovy] branch master updated: follow more standard naming convention for asciidoc fragments

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

[groovy] branch master updated: follow more standard naming convention for asciidoc fragments

paulk
This is an automated email from the ASF dual-hosted git repository.

paulk pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/groovy.git


The following commit(s) were added to refs/heads/master by this push:
     new 2510d14  follow more standard naming convention for asciidoc fragments
2510d14 is described below

commit 2510d149981d0430e969ca675bfa6558f940b72a
Author: Paul King <[hidden email]>
AuthorDate: Wed Oct 14 21:25:11 2020 +1000

    follow more standard naming convention for asciidoc fragments
---
 .../groovy/org.apache.groovy-asciidoctor.gradle    |  1 -
 ....adoc => _design-pattern-abstract-factory.adoc} |  0
 ...n-adapter.adoc => _design-pattern-adapter.adoc} |  0
 ...n-bouncer.adoc => _design-pattern-bouncer.adoc} |  0
 ...> _design-pattern-chain-of-responsibility.adoc} |  0
 ...n-command.adoc => _design-pattern-command.adoc} |  0
 ...mposite.adoc => _design-pattern-composite.adoc} |  0
 ...corator.adoc => _design-pattern-decorator.adoc} |  0
 ...gation.adoc => _design-pattern-delegation.adoc} |  0
 ...yweight.adoc => _design-pattern-flyweight.adoc} |  0
 ...iterator.adoc => _design-pattern-iterator.adoc} |  0
 ....adoc => _design-pattern-loan-my-resource.adoc} |  0
 ...ern-monoid.adoc => _design-pattern-monoid.adoc} |  0
 ...bject.adoc => _design-pattern-null-object.adoc} |  0
 ...observer.adoc => _design-pattern-observer.adoc} |  0
 ...y.adoc => _design-pattern-pimp-my-library.adoc} |  0
 ...ttern-proxy.adoc => _design-pattern-proxy.adoc} |  0
 ...ngleton.adoc => _design-pattern-singleton.adoc} |  0
 ...ttern-state.adoc => _design-pattern-state.adoc} |  0
 ...strategy.adoc => _design-pattern-strategy.adoc} |  0
 ...d.adoc => _design-pattern-template-method.adoc} |  0
 ...n-visitor.adoc => _design-pattern-visitor.adoc} |  0
 .../doc/{fragment_traits.adoc => _traits.adoc}     |  0
 ...ensions.adoc => _type-checking-extensions.adoc} |  0
 ...ections.adoc => _working-with-collections.adoc} |  0
 ..._working-with-io.adoc => _working-with-io.adoc} |  0
 src/spec/doc/core-domain-specific-languages.adoc   | 14 ++++----
 src/spec/doc/core-gdk.adoc                         |  8 ++---
 src/spec/doc/core-object-orientation.adoc          |  2 +-
 src/spec/doc/core-semantics.adoc                   |  2 +-
 src/spec/doc/core-testing-guide.adoc               |  2 +-
 src/spec/doc/design-patterns-in-groovy.adoc        | 42 +++++++++++-----------
 src/spec/doc/guide-integrating.adoc                |  4 +--
 ...fragment_ant-builder.adoc => _ant-builder.adoc} |  0
 ..._integrating-bsf.adoc => _integrating-bsf.adoc} |  0
 ...ypes.adoc => _working-with-datetime-types.adoc} |  0
 ...ypes.adoc => _working-with-dateutil-types.adoc} |  0
 ...agment_json-builder.adoc => _json-builder.adoc} |  0
 ...-builder.adoc => _streaming-jason-builder.adoc} |  0
 ...rating-jsr223.adoc => _integrating-jsr223.adoc} |  0
 ...ment_swing-builder.adoc => _swing-builder.adoc} |  0
 ...te-engine.adoc => _markup-template-engine.adoc} |  0
 .../src/spec/doc/template-engines.adoc             |  2 +-
 ...-with-junit5.adoc => _testing-with-junit5.adoc} |  0
 ...fragment_dom-builder.adoc => _dom-builder.adoc} |  0
 ...fragment_sax-builder.adoc => _sax-builder.adoc} |  0
 ...agment_stax-builder.adoc => _stax-builder.adoc} |  0
 47 files changed, 38 insertions(+), 39 deletions(-)

diff --git a/buildSrc/src/main/groovy/org.apache.groovy-asciidoctor.gradle b/buildSrc/src/main/groovy/org.apache.groovy-asciidoctor.gradle
index 81d5f02..bfe94c2 100644
--- a/buildSrc/src/main/groovy/org.apache.groovy-asciidoctor.gradle
+++ b/buildSrc/src/main/groovy/org.apache.groovy-asciidoctor.gradle
@@ -50,7 +50,6 @@ asciidoctor {
     sourceDir = project.file('src/spec/doc')
     sources {
         include '*.adoc'
-        exclude 'fragment_*.adoc'
     }
     outputDir = "$buildDir/asciidoc/html5"
     resources {
diff --git a/src/spec/doc/fragment_design-pattern-abstract-factory.adoc b/src/spec/doc/_design-pattern-abstract-factory.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-abstract-factory.adoc
rename to src/spec/doc/_design-pattern-abstract-factory.adoc
diff --git a/src/spec/doc/fragment_design-pattern-adapter.adoc b/src/spec/doc/_design-pattern-adapter.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-adapter.adoc
rename to src/spec/doc/_design-pattern-adapter.adoc
diff --git a/src/spec/doc/fragment_design-pattern-bouncer.adoc b/src/spec/doc/_design-pattern-bouncer.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-bouncer.adoc
rename to src/spec/doc/_design-pattern-bouncer.adoc
diff --git a/src/spec/doc/fragment_design-pattern-chain-of-responsibility.adoc b/src/spec/doc/_design-pattern-chain-of-responsibility.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-chain-of-responsibility.adoc
rename to src/spec/doc/_design-pattern-chain-of-responsibility.adoc
diff --git a/src/spec/doc/fragment_design-pattern-command.adoc b/src/spec/doc/_design-pattern-command.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-command.adoc
rename to src/spec/doc/_design-pattern-command.adoc
diff --git a/src/spec/doc/fragment_design-pattern-composite.adoc b/src/spec/doc/_design-pattern-composite.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-composite.adoc
rename to src/spec/doc/_design-pattern-composite.adoc
diff --git a/src/spec/doc/fragment_design-pattern-decorator.adoc b/src/spec/doc/_design-pattern-decorator.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-decorator.adoc
rename to src/spec/doc/_design-pattern-decorator.adoc
diff --git a/src/spec/doc/fragment_design-pattern-delegation.adoc b/src/spec/doc/_design-pattern-delegation.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-delegation.adoc
rename to src/spec/doc/_design-pattern-delegation.adoc
diff --git a/src/spec/doc/fragment_design-pattern-flyweight.adoc b/src/spec/doc/_design-pattern-flyweight.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-flyweight.adoc
rename to src/spec/doc/_design-pattern-flyweight.adoc
diff --git a/src/spec/doc/fragment_design-pattern-iterator.adoc b/src/spec/doc/_design-pattern-iterator.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-iterator.adoc
rename to src/spec/doc/_design-pattern-iterator.adoc
diff --git a/src/spec/doc/fragment_design-pattern-loan-my-resource.adoc b/src/spec/doc/_design-pattern-loan-my-resource.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-loan-my-resource.adoc
rename to src/spec/doc/_design-pattern-loan-my-resource.adoc
diff --git a/src/spec/doc/fragment_design-pattern-monoid.adoc b/src/spec/doc/_design-pattern-monoid.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-monoid.adoc
rename to src/spec/doc/_design-pattern-monoid.adoc
diff --git a/src/spec/doc/fragment_design-pattern-null-object.adoc b/src/spec/doc/_design-pattern-null-object.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-null-object.adoc
rename to src/spec/doc/_design-pattern-null-object.adoc
diff --git a/src/spec/doc/fragment_design-pattern-observer.adoc b/src/spec/doc/_design-pattern-observer.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-observer.adoc
rename to src/spec/doc/_design-pattern-observer.adoc
diff --git a/src/spec/doc/fragment_design-pattern-pimp-my-library.adoc b/src/spec/doc/_design-pattern-pimp-my-library.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-pimp-my-library.adoc
rename to src/spec/doc/_design-pattern-pimp-my-library.adoc
diff --git a/src/spec/doc/fragment_design-pattern-proxy.adoc b/src/spec/doc/_design-pattern-proxy.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-proxy.adoc
rename to src/spec/doc/_design-pattern-proxy.adoc
diff --git a/src/spec/doc/fragment_design-pattern-singleton.adoc b/src/spec/doc/_design-pattern-singleton.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-singleton.adoc
rename to src/spec/doc/_design-pattern-singleton.adoc
diff --git a/src/spec/doc/fragment_design-pattern-state.adoc b/src/spec/doc/_design-pattern-state.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-state.adoc
rename to src/spec/doc/_design-pattern-state.adoc
diff --git a/src/spec/doc/fragment_design-pattern-strategy.adoc b/src/spec/doc/_design-pattern-strategy.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-strategy.adoc
rename to src/spec/doc/_design-pattern-strategy.adoc
diff --git a/src/spec/doc/fragment_design-pattern-template-method.adoc b/src/spec/doc/_design-pattern-template-method.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-template-method.adoc
rename to src/spec/doc/_design-pattern-template-method.adoc
diff --git a/src/spec/doc/fragment_design-pattern-visitor.adoc b/src/spec/doc/_design-pattern-visitor.adoc
similarity index 100%
rename from src/spec/doc/fragment_design-pattern-visitor.adoc
rename to src/spec/doc/_design-pattern-visitor.adoc
diff --git a/src/spec/doc/fragment_traits.adoc b/src/spec/doc/_traits.adoc
similarity index 100%
rename from src/spec/doc/fragment_traits.adoc
rename to src/spec/doc/_traits.adoc
diff --git a/src/spec/doc/fragment_type-checking-extensions.adoc b/src/spec/doc/_type-checking-extensions.adoc
similarity index 100%
rename from src/spec/doc/fragment_type-checking-extensions.adoc
rename to src/spec/doc/_type-checking-extensions.adoc
diff --git a/src/spec/doc/fragment_working-with-collections.adoc b/src/spec/doc/_working-with-collections.adoc
similarity index 100%
rename from src/spec/doc/fragment_working-with-collections.adoc
rename to src/spec/doc/_working-with-collections.adoc
diff --git a/src/spec/doc/fragment_working-with-io.adoc b/src/spec/doc/_working-with-io.adoc
similarity index 100%
rename from src/spec/doc/fragment_working-with-io.adoc
rename to src/spec/doc/_working-with-io.adoc
diff --git a/src/spec/doc/core-domain-specific-languages.adoc b/src/spec/doc/core-domain-specific-languages.adoc
index 556b993..66a0b76 100644
--- a/src/spec/doc/core-domain-specific-languages.adoc
+++ b/src/spec/doc/core-domain-specific-languages.adoc
@@ -1064,11 +1064,11 @@ See <<{xml-userguide}#_markupbuilder,Creating Xml - MarkupBuilder>>.
 
 See <<{xml-userguide}#_streamingmarkupbuilder,Creating Xml - StreamingMarkupBuilder>>.
 
-include::../../../subprojects/groovy-xml/src/spec/doc/fragment_sax-builder.adoc[leveloffset=+3]
+include::../../../subprojects/groovy-xml/src/spec/doc/_sax-builder.adoc[leveloffset=+3]
 
-include::../../../subprojects/groovy-xml/src/spec/doc/fragment_stax-builder.adoc[leveloffset=+3]
+include::../../../subprojects/groovy-xml/src/spec/doc/_stax-builder.adoc[leveloffset=+3]
 
-include::../../../subprojects/groovy-xml/src/spec/doc/fragment_dom-builder.adoc[leveloffset=+3]
+include::../../../subprojects/groovy-xml/src/spec/doc/_dom-builder.adoc[leveloffset=+3]
 
 ==== NodeBuilder
 
@@ -1087,13 +1087,13 @@ Now you can process the data further, e.g. by using <<{core-semantics}#gpath_exp
 include::../test/builder/NodeBuilderTest.groovy[tags=node_builder_gpath_assert,indent=0]
 ----
 
-include::../../../subprojects/groovy-json/src/spec/doc/fragment_json-builder.adoc[leveloffset=+3]
+include::../../../subprojects/groovy-json/src/spec/doc/_json-builder.adoc[leveloffset=+3]
 
-include::../../../subprojects/groovy-json/src/spec/doc/fragment_streaming-jason-builder.adoc[leveloffset=+3]
+include::../../../subprojects/groovy-json/src/spec/doc/_streaming-jason-builder.adoc[leveloffset=+3]
 
-include::../../../subprojects/groovy-swing/src/spec/doc/fragment_swing-builder.adoc[leveloffset=+3]
+include::../../../subprojects/groovy-swing/src/spec/doc/_swing-builder.adoc[leveloffset=+3]
 
-include::../../../subprojects/groovy-ant/src/spec/doc/fragment_ant-builder.adoc[leveloffset=+3]
+include::../../../subprojects/groovy-ant/src/spec/doc/_ant-builder.adoc[leveloffset=+3]
 
 ==== CliBuilder
 
diff --git a/src/spec/doc/core-gdk.adoc b/src/spec/doc/core-gdk.adoc
index c4656fb..95a1a98 100644
--- a/src/spec/doc/core-gdk.adoc
+++ b/src/spec/doc/core-gdk.adoc
@@ -22,13 +22,13 @@
 = Groovy Development Kit
 
 
-include::fragment_working-with-io.adoc[leveloffset=+1]
+include::_working-with-io.adoc[leveloffset=+1]
 
-include::fragment_working-with-collections.adoc[leveloffset=+1]
+include::_working-with-collections.adoc[leveloffset=+1]
 
-include::../../../subprojects/groovy-dateutil/src/spec/doc/fragment_working-with-dateutil-types.adoc[leveloffset=+1]
+include::../../../subprojects/groovy-dateutil/src/spec/doc/_working-with-dateutil-types.adoc[leveloffset=+1]
 
-include::../../../subprojects/groovy-datetime/src/spec/doc/fragment_working-with-datetime-types.adoc[leveloffset=+1]
+include::../../../subprojects/groovy-datetime/src/spec/doc/_working-with-datetime-types.adoc[leveloffset=+1]
 
 == Handy utilities
 
diff --git a/src/spec/doc/core-object-orientation.adoc b/src/spec/doc/core-object-orientation.adoc
index ab9d5e7..b23b90b 100644
--- a/src/spec/doc/core-object-orientation.adoc
+++ b/src/spec/doc/core-object-orientation.adoc
@@ -1141,5 +1141,5 @@ single one corresponding to `@CompileStatic(TypeCheckingMode.SKIP)`.
 (TBD)
 
 
-include::fragment_traits.adoc[leveloffset=+1]
+include::_traits.adoc[leveloffset=+1]
 
diff --git a/src/spec/doc/core-semantics.adoc b/src/spec/doc/core-semantics.adoc
index 7fc38b0..a86bf02 100644
--- a/src/spec/doc/core-semantics.adoc
+++ b/src/spec/doc/core-semantics.adoc
@@ -2197,5 +2197,5 @@ There is only one way to determine which version you should choose: measuring. T
 *and* the JVM that you use, the performance can be significantly different. In particular, the _invokedynamic_ version of
 Groovy is very sensitive to the JVM version in use.
 
-include::fragment_type-checking-extensions.adoc[leveloffset=+1]
+include::_type-checking-extensions.adoc[leveloffset=+1]
 
diff --git a/src/spec/doc/core-testing-guide.adoc b/src/spec/doc/core-testing-guide.adoc
index 526b62c..32ac146 100644
--- a/src/spec/doc/core-testing-guide.adoc
+++ b/src/spec/doc/core-testing-guide.adoc
@@ -492,7 +492,7 @@ exception:
 include::../test/testingguide/JUnit4ExampleTests.groovy[tags=should_fail_return,indent=0]
 ----
 
-include::../../../subprojects/groovy-test-junit5/src/spec/doc/fragment_testing-with-junit5.adoc[leveloffset=+1]
+include::../../../subprojects/groovy-test-junit5/src/spec/doc/_testing-with-junit5.adoc[leveloffset=+1]
 
 == Testing with Spock
 
diff --git a/src/spec/doc/design-patterns-in-groovy.adoc b/src/spec/doc/design-patterns-in-groovy.adoc
index 4071fc2..d951f58 100644
--- a/src/spec/doc/design-patterns-in-groovy.adoc
+++ b/src/spec/doc/design-patterns-in-groovy.adoc
@@ -31,47 +31,47 @@ Design patterns also apply to Groovy:
 
 == Patterns
 
-include::fragment_design-pattern-abstract-factory.adoc[leveloffset=+2]
+include::_design-pattern-abstract-factory.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-adapter.adoc[leveloffset=+2]
+include::_design-pattern-adapter.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-bouncer.adoc[leveloffset=+2]
+include::_design-pattern-bouncer.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-chain-of-responsibility.adoc[leveloffset=+2]
+include::_design-pattern-chain-of-responsibility.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-command.adoc[leveloffset=+2]
+include::_design-pattern-command.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-composite.adoc[leveloffset=+2]
+include::_design-pattern-composite.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-decorator.adoc[leveloffset=+2]
+include::_design-pattern-decorator.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-delegation.adoc[leveloffset=+2]
+include::_design-pattern-delegation.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-flyweight.adoc[leveloffset=+2]
+include::_design-pattern-flyweight.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-iterator.adoc[leveloffset=+2]
+include::_design-pattern-iterator.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-loan-my-resource.adoc[leveloffset=+2]
+include::_design-pattern-loan-my-resource.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-monoid.adoc[leveloffset=+2]
+include::_design-pattern-monoid.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-null-object.adoc[leveloffset=+2]
+include::_design-pattern-null-object.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-observer.adoc[leveloffset=+2]
+include::_design-pattern-observer.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-pimp-my-library.adoc[leveloffset=+2]
+include::_design-pattern-pimp-my-library.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-proxy.adoc[leveloffset=+2]
+include::_design-pattern-proxy.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-singleton.adoc[leveloffset=+2]
+include::_design-pattern-singleton.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-state.adoc[leveloffset=+2]
+include::_design-pattern-state.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-strategy.adoc[leveloffset=+2]
+include::_design-pattern-strategy.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-template-method.adoc[leveloffset=+2]
+include::_design-pattern-template-method.adoc[leveloffset=+2]
 
-include::fragment_design-pattern-visitor.adoc[leveloffset=+2]
+include::_design-pattern-visitor.adoc[leveloffset=+2]
 
 == References
 
diff --git a/src/spec/doc/guide-integrating.adoc b/src/spec/doc/guide-integrating.adoc
index 86647c8..b4d29de 100644
--- a/src/spec/doc/guide-integrating.adoc
+++ b/src/spec/doc/guide-integrating.adoc
@@ -323,8 +323,8 @@ stub generation is done, for the joint compiler.
 
 However, overriding `CompilationUnit` is not recommended and should only be done if no other standard solution works.
 
-include::../../../subprojects/groovy-bsf/src/spec/doc/fragment_integrating-bsf.adoc[leveloffset=+1]
+include::../../../subprojects/groovy-bsf/src/spec/doc/_integrating-bsf.adoc[leveloffset=+1]
 
-include::../../../subprojects/groovy-jsr223/src/spec/doc/fragment_integrating-jsr223.adoc[leveloffset=+1]
+include::../../../subprojects/groovy-jsr223/src/spec/doc/_integrating-jsr223.adoc[leveloffset=+1]
 
 
diff --git a/subprojects/groovy-ant/src/spec/doc/fragment_ant-builder.adoc b/subprojects/groovy-ant/src/spec/doc/_ant-builder.adoc
similarity index 100%
rename from subprojects/groovy-ant/src/spec/doc/fragment_ant-builder.adoc
rename to subprojects/groovy-ant/src/spec/doc/_ant-builder.adoc
diff --git a/subprojects/groovy-bsf/src/spec/doc/fragment_integrating-bsf.adoc b/subprojects/groovy-bsf/src/spec/doc/_integrating-bsf.adoc
similarity index 100%
rename from subprojects/groovy-bsf/src/spec/doc/fragment_integrating-bsf.adoc
rename to subprojects/groovy-bsf/src/spec/doc/_integrating-bsf.adoc
diff --git a/subprojects/groovy-datetime/src/spec/doc/fragment_working-with-datetime-types.adoc b/subprojects/groovy-datetime/src/spec/doc/_working-with-datetime-types.adoc
similarity index 100%
rename from subprojects/groovy-datetime/src/spec/doc/fragment_working-with-datetime-types.adoc
rename to subprojects/groovy-datetime/src/spec/doc/_working-with-datetime-types.adoc
diff --git a/subprojects/groovy-dateutil/src/spec/doc/fragment_working-with-dateutil-types.adoc b/subprojects/groovy-dateutil/src/spec/doc/_working-with-dateutil-types.adoc
similarity index 100%
rename from subprojects/groovy-dateutil/src/spec/doc/fragment_working-with-dateutil-types.adoc
rename to subprojects/groovy-dateutil/src/spec/doc/_working-with-dateutil-types.adoc
diff --git a/subprojects/groovy-json/src/spec/doc/fragment_json-builder.adoc b/subprojects/groovy-json/src/spec/doc/_json-builder.adoc
similarity index 100%
rename from subprojects/groovy-json/src/spec/doc/fragment_json-builder.adoc
rename to subprojects/groovy-json/src/spec/doc/_json-builder.adoc
diff --git a/subprojects/groovy-json/src/spec/doc/fragment_streaming-jason-builder.adoc b/subprojects/groovy-json/src/spec/doc/_streaming-jason-builder.adoc
similarity index 100%
rename from subprojects/groovy-json/src/spec/doc/fragment_streaming-jason-builder.adoc
rename to subprojects/groovy-json/src/spec/doc/_streaming-jason-builder.adoc
diff --git a/subprojects/groovy-jsr223/src/spec/doc/fragment_integrating-jsr223.adoc b/subprojects/groovy-jsr223/src/spec/doc/_integrating-jsr223.adoc
similarity index 100%
rename from subprojects/groovy-jsr223/src/spec/doc/fragment_integrating-jsr223.adoc
rename to subprojects/groovy-jsr223/src/spec/doc/_integrating-jsr223.adoc
diff --git a/subprojects/groovy-swing/src/spec/doc/fragment_swing-builder.adoc b/subprojects/groovy-swing/src/spec/doc/_swing-builder.adoc
similarity index 100%
rename from subprojects/groovy-swing/src/spec/doc/fragment_swing-builder.adoc
rename to subprojects/groovy-swing/src/spec/doc/_swing-builder.adoc
diff --git a/subprojects/groovy-templates/src/spec/doc/fragment_markup-template-engine.adoc b/subprojects/groovy-templates/src/spec/doc/_markup-template-engine.adoc
similarity index 100%
rename from subprojects/groovy-templates/src/spec/doc/fragment_markup-template-engine.adoc
rename to subprojects/groovy-templates/src/spec/doc/_markup-template-engine.adoc
diff --git a/subprojects/groovy-templates/src/spec/doc/template-engines.adoc b/subprojects/groovy-templates/src/spec/doc/template-engines.adoc
index c2cd114..b757cfa 100644
--- a/subprojects/groovy-templates/src/spec/doc/template-engines.adoc
+++ b/subprojects/groovy-templates/src/spec/doc/template-engines.adoc
@@ -197,7 +197,7 @@ This example will produce this output:
 </document>
 ----
 
-include::../doc/fragment_markup-template-engine.adoc[leveloffset=+1]
+include::../doc/_markup-template-engine.adoc[leveloffset=+1]
 
 == Other solutions
 
diff --git a/subprojects/groovy-test-junit5/src/spec/doc/fragment_testing-with-junit5.adoc b/subprojects/groovy-test-junit5/src/spec/doc/_testing-with-junit5.adoc
similarity index 100%
rename from subprojects/groovy-test-junit5/src/spec/doc/fragment_testing-with-junit5.adoc
rename to subprojects/groovy-test-junit5/src/spec/doc/_testing-with-junit5.adoc
diff --git a/subprojects/groovy-xml/src/spec/doc/fragment_dom-builder.adoc b/subprojects/groovy-xml/src/spec/doc/_dom-builder.adoc
similarity index 100%
rename from subprojects/groovy-xml/src/spec/doc/fragment_dom-builder.adoc
rename to subprojects/groovy-xml/src/spec/doc/_dom-builder.adoc
diff --git a/subprojects/groovy-xml/src/spec/doc/fragment_sax-builder.adoc b/subprojects/groovy-xml/src/spec/doc/_sax-builder.adoc
similarity index 100%
rename from subprojects/groovy-xml/src/spec/doc/fragment_sax-builder.adoc
rename to subprojects/groovy-xml/src/spec/doc/_sax-builder.adoc
diff --git a/subprojects/groovy-xml/src/spec/doc/fragment_stax-builder.adoc b/subprojects/groovy-xml/src/spec/doc/_stax-builder.adoc
similarity index 100%
rename from subprojects/groovy-xml/src/spec/doc/fragment_stax-builder.adoc
rename to subprojects/groovy-xml/src/spec/doc/_stax-builder.adoc