You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2019/09/24 23:31:37 UTC
[isis] 07/07: ISIS-2062: also incorporates BDD spec support chapter
into testing guide.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch v2
in repository https://gitbox.apache.org/repos/asf/isis.git
commit af285cc3fd8ac505573aaf35209095feeed994db
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Wed Sep 25 00:31:15 2019 +0100
ISIS-2062: also incorporates BDD spec support chapter into testing guide.
---
antora/components/toc/modules/ROOT/nav.adoc | 2 --
antora/components/toc/modules/ROOT/pages/about.adoc | 4 ----
antora/components/toc/modules/ROOT/pages/guides.adoc | 9 +++------
.../ROOT/pages/what-is-apache-isis/screencasts.adoc | 6 +++---
.../ROOT/partials/_powered-by_gesconsultor-grc.adoc | 2 +-
.../hints-and-tips/how-run-fixtures-on-app-startup.adoc | 2 +-
core/_adoc-rg/modules/ant/pages/Inject.adoc | 2 +-
.../modules/cms/pages/classes/super/FixtureScript.adoc | 2 +-
.../modules/cms/pages/classes/super/FixtureScripts.adoc | 2 +-
.../modules/svc/pages/testing/FixtureScripts.adoc | 2 +-
.../_adoc-rg/modules/svc/pages/testing/SudoService.adoc | 2 +-
.../modules/svc/pages/testing/SwitchUserService.adoc | 2 +-
core/testsupport/_adoc/modules/ROOT/nav.adoc | 1 -
.../_adoc/modules/ROOT/pages/bdd-spec-support.adoc | 17 -----------------
core/testsupport/_adoc/modules/ROOT/partials/nav.adoc | 4 ++--
.../apps/simpleapp/_adoc/modules/ROOT/pages/about.adoc | 4 ++--
.../ROOT/pages/fixture-scripts/api-and-usage.adoc | 2 +-
extensions/specsupport/_adoc/modules/ROOT/nav.adoc | 2 +-
.../specsupport/_adoc/modules/ROOT/pages/about.adoc | 15 +++++++++++++--
.../{_partials => bdd-spec-support}/_attributes.adoc | 0
.../ROOT/pages/bdd-spec-support/how-it-works.adoc | 0
.../pages/bdd-spec-support/maven-configuration.adoc | 0
.../ROOT/pages/bdd-spec-support/writing-a-bdd-spec.adoc | 0
.../_adoc/modules/ROOT/partials}/_attributes.adoc | 2 +-
24 files changed, 34 insertions(+), 50 deletions(-)
diff --git a/antora/components/toc/modules/ROOT/nav.adoc b/antora/components/toc/modules/ROOT/nav.adoc
index d177b6a..2dce8ea 100644
--- a/antora/components/toc/modules/ROOT/nav.adoc
+++ b/antora/components/toc/modules/ROOT/nav.adoc
@@ -29,8 +29,6 @@
* Testing & Prototyping
** *xref:testing:ROOT:about.adoc[Testing]*
-** xref:ext-fixtures:ROOT:about.adoc[Fixtures (extension)]
-** xref:ext-specsupport:ROOT:about.adoc[BDD (extension)]
* Wicket Viewer
diff --git a/antora/components/toc/modules/ROOT/pages/about.adoc b/antora/components/toc/modules/ROOT/pages/about.adoc
index f1f0af6..c46936d 100644
--- a/antora/components/toc/modules/ROOT/pages/about.adoc
+++ b/antora/components/toc/modules/ROOT/pages/about.adoc
@@ -42,10 +42,6 @@ _Tutorials:_
* *xref:testing:ROOT:about.adoc[Testing]*
-_Extensions_
-
-* xref:ext-fixtures:ROOT:about.adoc[Fixtures]
-* xref:ext-specsupport:ROOT:about.adoc[BDD]
diff --git a/antora/components/toc/modules/ROOT/pages/guides.adoc b/antora/components/toc/modules/ROOT/pages/guides.adoc
index d507852..642ecb8 100644
--- a/antora/components/toc/modules/ROOT/pages/guides.adoc
+++ b/antora/components/toc/modules/ROOT/pages/guides.adoc
@@ -19,11 +19,8 @@ This page lists the user and reference guides available for developers to create
== Testing & Prototyping
-* xref:testing:ROOT:about.adoc[Unit & Integration Testing]
-
-_Extensions_
-
-* xref:ext-fixtures:ROOT:about.adoc[Fixtures]
-* xref:ext-specsupport:ROOT:about.adoc[BDD]
+* xref:testing:ROOT:about.adoc[Testing]
++
+Support for unit tests and for integration tests, also extensions to support BDD support and fixtures.
diff --git a/antora/components/toc/modules/ROOT/pages/what-is-apache-isis/screencasts.adoc b/antora/components/toc/modules/ROOT/pages/what-is-apache-isis/screencasts.adoc
index afe91e7..ed07ead 100644
--- a/antora/components/toc/modules/ROOT/pages/what-is-apache-isis/screencasts.adoc
+++ b/antora/components/toc/modules/ROOT/pages/what-is-apache-isis/screencasts.adoc
@@ -79,7 +79,7 @@ include::partial$_screencasts-playlists.adoc[]
|link:https://www.youtube.com/watch?v=pH02g0l2GKY[005^] +
-Using xref:testing:ROOT:fixture-scripts.adoc[fixture scripts] to initialize the database, eg while prototyping and for demos
+Using xref:ext-fixtures:ROOT:about.adoc[fixture scripts] to initialize the database, eg while prototyping and for demos
||x|||||||||
@@ -187,7 +187,7 @@ How to implement a derived collection on a domain object.
|link:https://www.youtube.com/watch?v=l_oZymgb65I[017^] +
-Extending a xref:testing:ROOT:fixture-scripts.adoc[fixture script] to more easily demonstrate new functionality.
+Extending a xref:ext-fixtures:ROOT:about.adoc[fixture script] to more easily demonstrate new functionality.
||x|||||||||
@@ -367,7 +367,7 @@ How to provide a set of xref:rg:cms:methods.adoc#choices[choices] (a drop-down l
|link:https://www.youtube.com/watch?v=fKo6aTPK-gk[035^] +
-How to use the xref:rg:cms:methods.adoc#choices[choices] supporting methods as a source for default values within a xref:testing:ROOT:fixture-scripts.adoc[fixture script].
+How to use the xref:rg:cms:methods.adoc#choices[choices] supporting methods as a source for default values within a xref:ext-fixtures:ROOT:about.adoc[fixture script].
||x|||||||x||
diff --git a/antora/components/toc/modules/ROOT/partials/_powered-by_gesconsultor-grc.adoc b/antora/components/toc/modules/ROOT/partials/_powered-by_gesconsultor-grc.adoc
index 4194f43..2961a13 100644
--- a/antora/components/toc/modules/ROOT/partials/_powered-by_gesconsultor-grc.adoc
+++ b/antora/components/toc/modules/ROOT/partials/_powered-by_gesconsultor-grc.adoc
@@ -80,7 +80,7 @@ At the last count more than 400 domain entities, across 6 different Bounded Cont
At the Domain level, we also extensively use the xref:ug:fun:building-blocks.adoc#domain-events[domain events] functionality available in Apache Isis, along with many of the (non-ASF) link:https://platform.incode.org[Incode Platform^] (such as audit, security and excel modules).
-The GRC platform currently has more than 5600 automated tests, about 2000 being xref:testing:ROOT:bdd-spec-support.adoc[BDD tests] and 3600 xref:testing:ROOT:integ-test-support.adoc[integration tests], all leveraging Apache Isis' extensive testing capabilities.
+The GRC platform currently has more than 5600 automated tests, about 2000 being xref:ext-specsupport:ROOT:about.adoc[BDD tests] and 3600 xref:testing:ROOT:integ-test-support.adoc[integration tests], all leveraging Apache Isis' extensive testing capabilities.
== Summing up
diff --git a/antora/components/toc/modules/devguide/pages/hints-and-tips/how-run-fixtures-on-app-startup.adoc b/antora/components/toc/modules/devguide/pages/hints-and-tips/how-run-fixtures-on-app-startup.adoc
index 993f08a..ad378e1 100644
--- a/antora/components/toc/modules/devguide/pages/hints-and-tips/how-run-fixtures-on-app-startup.adoc
+++ b/antora/components/toc/modules/devguide/pages/hints-and-tips/how-run-fixtures-on-app-startup.adoc
@@ -13,7 +13,7 @@ Hook up into the webapp start?
Use events?_
-The standard approach is to use xref:testing:ROOT:fixture-scripts.adoc[fixture scripts].
+The standard approach is to use xref:ext-fixtures:ROOT:about.adoc[fixture scripts].
These can be run in on start-up typically by being specified in the xref:rg:cms:classes/AppManifest-bootstrapping.adoc[`AppManifest`], see for example the xref:simpleapp:ROOT:about.adoc[SimpleApp archetype].
Alternatively just set `isis.fixtures` and `isis.persistor.datanucleus.install-fixtures` properties.
diff --git a/core/_adoc-rg/modules/ant/pages/Inject.adoc b/core/_adoc-rg/modules/ant/pages/Inject.adoc
index 5812367..633baa0 100644
--- a/core/_adoc-rg/modules/ant/pages/Inject.adoc
+++ b/core/_adoc-rg/modules/ant/pages/Inject.adoc
@@ -5,7 +5,7 @@ include::_attributes.adoc[]
Apache Isis automatically injects domain services into other domain services and also into domain objects and view models.
-In fact, it also injects domain services into xref:testing:ROOT:integ-test-support.adoc[integration tests] and xref:testing:ROOT:fixture-scripts.adoc[fixture scripts].
+In fact, it also injects domain services into xref:testing:ROOT:integ-test-support.adoc[integration tests] and xref:ext-fixtures:ROOT:about.adoc[fixture scripts].
[NOTE]
====
diff --git a/core/_adoc-rg/modules/cms/pages/classes/super/FixtureScript.adoc b/core/_adoc-rg/modules/cms/pages/classes/super/FixtureScript.adoc
index 578d56a..cb3da88 100644
--- a/core/_adoc-rg/modules/cms/pages/classes/super/FixtureScript.adoc
+++ b/core/_adoc-rg/modules/cms/pages/classes/super/FixtureScript.adoc
@@ -17,5 +17,5 @@ protected abstract void execute(final ExecutionContext executionContext);
In this method the fixture script can in theory do anything, but in practice it is recommended that it uses injected domain services to set up data.
The provided `ExecutionContext` is used to invoke child fixture scripts, and alsocan be used to store references to any created objects (so that the calling test can access these objects/so that they are rendered in the view model).
-See the see the xref:testing:ROOT:fixture-scripts.adoc[user guide's testing chapter] for further discussion on the use of fixture scripts, in particular xref:testing:ROOT:fixture-scripts/api-and-usage.adoc[fixture scripts' API and usage].
+See the see the xref:ext-fixtures:ROOT:about.adoc[user guide's testing chapter] for further discussion on the use of fixture scripts, in particular xref:ext-fixtures:ROOT:about.adoc#api-and-usage[fixture scripts' API and usage].
diff --git a/core/_adoc-rg/modules/cms/pages/classes/super/FixtureScripts.adoc b/core/_adoc-rg/modules/cms/pages/classes/super/FixtureScripts.adoc
index b6ac514..a59e819 100644
--- a/core/_adoc-rg/modules/cms/pages/classes/super/FixtureScripts.adoc
+++ b/core/_adoc-rg/modules/cms/pages/classes/super/FixtureScripts.adoc
@@ -8,4 +8,4 @@ This abstract class constitutes the API of a domain service to execute xref:rg:c
For more information, see xref:rg:svc:testing/FixtureScripts.adoc[`FixtureScripts`] in the domain services guide.
-See the see the xref:testing:ROOT:fixture-scripts.adoc[user guide's testing chapter] for further discussion on the use of fixture scripts, in particular xref:testing:ROOT:fixture-scripts/api-and-usage.adoc[fixture scripts' API and usage].
+See the see the xref:ext-fixtures:ROOT:about.adoc[testing guide] for further discussion on the use of fixture scripts, in particular xref:ext-fixtures:ROOT:about.adoc#api-and-usage[fixture scripts' API and usage].
diff --git a/core/_adoc-rg/modules/svc/pages/testing/FixtureScripts.adoc b/core/_adoc-rg/modules/svc/pages/testing/FixtureScripts.adoc
index 1fe21de..fe1eef5 100644
--- a/core/_adoc-rg/modules/svc/pages/testing/FixtureScripts.adoc
+++ b/core/_adoc-rg/modules/svc/pages/testing/FixtureScripts.adoc
@@ -6,7 +6,7 @@ include::_attributes.adoc[]
-The `FixtureScripts` service provides the ability to execute xref:testing:ROOT:fixture-scripts/api-and-usage.adoc[fixture scripts].
+The `FixtureScripts` service provides the ability to execute xref:ext-fixtures:ROOT:about.adoc#api-and-usage[fixture scripts].
The default implementation of this service, `FixtureScriptsDefault`, uses the associated xref:rg:svc:testing/FixtureScriptsSpecificationProvider.adoc[`FixtureScriptsSpecificationProvider`] to obtain a `FixtureScriptsSpecification`.
This configures this service, for example telling it which package to search for `FixtureScript` classes, how to execute those classes, and hints that influence the UI.
diff --git a/core/_adoc-rg/modules/svc/pages/testing/SudoService.adoc b/core/_adoc-rg/modules/svc/pages/testing/SudoService.adoc
index 53349a1..1dfc51a 100644
--- a/core/_adoc-rg/modules/svc/pages/testing/SudoService.adoc
+++ b/core/_adoc-rg/modules/svc/pages/testing/SudoService.adoc
@@ -7,7 +7,7 @@ include::_attributes.adoc[]
The `SudoService` allows the current user reported by the xref:rg:svc:core-domain-api/UserService.adoc[`UserService`] to be temporarily changed to some other user.
-This is useful both for xref:testing:ROOT:integ-test-support.adoc[integration testing] (eg if testing a workflow system whereby objects are moved from one user to another) and while running xref:testing:ROOT:fixture-scripts.adoc[fixture scripts] (eg setting up objects that would normally require several users to have acted upon the objects).
+This is useful both for xref:testing:ROOT:integ-test-support.adoc[integration testing] (eg if testing a workflow system whereby objects are moved from one user to another) and while running xref:ext-fixtures:ROOT:about.adoc[fixture scripts] (eg setting up objects that would normally require several users to have acted upon the objects).
== API
diff --git a/core/_adoc-rg/modules/svc/pages/testing/SwitchUserService.adoc b/core/_adoc-rg/modules/svc/pages/testing/SwitchUserService.adoc
index a3ad847..d25743d 100644
--- a/core/_adoc-rg/modules/svc/pages/testing/SwitchUserService.adoc
+++ b/core/_adoc-rg/modules/svc/pages/testing/SwitchUserService.adoc
@@ -13,7 +13,7 @@ different users of the system.
[NOTE]
====
-This service is deprecated; use xref:testing:ROOT:fixture-scripts.adoc[fixture scripts] and the
+This service is deprecated; use xref:ext-fixtures:ROOT:about.adoc[fixture scripts] and the
xref:rg:svc:testing/SudoService.adoc[`SudoService`] instead.
====
diff --git a/core/testsupport/_adoc/modules/ROOT/nav.adoc b/core/testsupport/_adoc/modules/ROOT/nav.adoc
index 6b039a6..5df99fd 100644
--- a/core/testsupport/_adoc/modules/ROOT/nav.adoc
+++ b/core/testsupport/_adoc/modules/ROOT/nav.adoc
@@ -1,3 +1,2 @@
include::testing:ROOT:partial$nav.adoc[]
-//include::testing:ROOT:nav.adoc[]
diff --git a/core/testsupport/_adoc/modules/ROOT/pages/bdd-spec-support.adoc b/core/testsupport/_adoc/modules/ROOT/pages/bdd-spec-support.adoc
deleted file mode 100644
index cde0219..0000000
--- a/core/testsupport/_adoc/modules/ROOT/pages/bdd-spec-support.adoc
+++ /dev/null
@@ -1,17 +0,0 @@
-= BDD Spec Support
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
-include::_attributes.adoc[]
-
-
-link:http://en.wikipedia.org/wiki/Behavior-driven_development[Behaviour-driven design] (BDD) redefines testing not as an after-the-fact "let's check the system works", but rather as a means to work with the domain expert to (a) specify the behaviour of the feature _before_ starting implementation, and (b) provide a means that the domain expert can verify the feature after it has been implemented.
-
-Since domain experts are usually non-technical (at least, they are unlikely to be able to read or want to learn how to read JUnit/Java code), then applying BDD typically requires writing specifications in using structured English text and (ASCII) tables. The BDD tooling parses this text and uses it to actually interact with the system under test. As a byproduct the BDD frameworks generate readable output of some form; this is often an annotated version of the original specification, ma [...]
-
-There are many BDD tools out there; Apache Isis provides an integration with link:https://cucumber.io/docs/reference/jvm#java[Cucumber JVM] (see also the https://github.com/cucumber/cucumber-jvm[github site]):
-
-
-
-
-include::bdd-spec-support/how-it-works.adoc[leveloffset=+1]
-include::bdd-spec-support/writing-a-bdd-spec.adoc[leveloffset=+1]
-include::bdd-spec-support/maven-configuration.adoc[leveloffset=+1]
diff --git a/core/testsupport/_adoc/modules/ROOT/partials/nav.adoc b/core/testsupport/_adoc/modules/ROOT/partials/nav.adoc
index 15eff13..0b105d3 100644
--- a/core/testsupport/_adoc/modules/ROOT/partials/nav.adoc
+++ b/core/testsupport/_adoc/modules/ROOT/partials/nav.adoc
@@ -5,5 +5,5 @@
** xref:testing:ROOT:overview.adoc[Overview]
** xref:testing:ROOT:unit-test-support.adoc[Unit Test Support]
** xref:testing:ROOT:integ-test-support.adoc[Integ Test Support]
-** xref:testing:ROOT:bdd-spec-support.adoc[BDD Spec Support]
-** xref:ext-fixtures:ROOT:about.adoc[Fixture Scripts]
+** xref:ext-specsupport:ROOT:about.adoc[BDD Spec Support (extension)]
+** xref:ext-fixtures:ROOT:about.adoc[Fixture Scripts (extension)]
diff --git a/examples/apps/simpleapp/_adoc/modules/ROOT/pages/about.adoc b/examples/apps/simpleapp/_adoc/modules/ROOT/pages/about.adoc
index ac089ac..9bc8463 100644
--- a/examples/apps/simpleapp/_adoc/modules/ROOT/pages/about.adoc
+++ b/examples/apps/simpleapp/_adoc/modules/ROOT/pages/about.adoc
@@ -408,7 +408,7 @@ public class SimpleModule extends ModuleAbstract {
}
----
-In the `fixture` subpackage is the `SimpleObject_persona` "persona" which uses the corresponding `SimpleObjectBuilder` builder script; further discussion on this pattern xref:testing:ROOT:fixture-scripts/api-and-usage#persona-and-builders.adoc[here].
+In the `fixture` subpackage is the `SimpleObject_persona` "persona" which uses the corresponding `SimpleObjectBuilder` builder script; further discussion on this pattern xref:ext-fixtures:ROOT:about.adoc#persona-and-builders.adoc[here].
These fixtures are also used by "local" integration tests, which reside under `src/test/java`.
There are also unit tests and "glue" for the BDD specs:
@@ -670,7 +670,7 @@ image::simpleapp-webapp-before-launch.png[width="600px",link="{imagesdir}/simple
== Running with Fixtures
It is also possible to start the application with a pre-defined set of data; useful for demos or manual exploratory testing.
-This is done by specifying a xref:testing:ROOT:fixture-scripts.adoc[fixture script] on the command line.
+This is done by specifying a xref:ext-fixtures:ROOT:about.adoc[fixture script] on the command line.
If you are running the app from an IDE, then you can specify the fixture script using the `--fixture` flag. The archetype provides the `domainapp.fixture.scenarios.RecreateSimpleObjects` fixture script, for example:
diff --git a/extensions/fixtures/_adoc/modules/ROOT/pages/fixture-scripts/api-and-usage.adoc b/extensions/fixtures/_adoc/modules/ROOT/pages/fixture-scripts/api-and-usage.adoc
index f22d3b5..f3c6481 100644
--- a/extensions/fixtures/_adoc/modules/ROOT/pages/fixture-scripts/api-and-usage.adoc
+++ b/extensions/fixtures/_adoc/modules/ROOT/pages/fixture-scripts/api-and-usage.adoc
@@ -39,7 +39,7 @@ public class DomainAppFixtureScriptsSpecificationProvider
}
----
<1> search for all fixture scripts under the package containing this class
-<2> if the same fixture script (class) is encountered more than once, then run anyway; more on this in xref:testing:ROOT:fixture-scripts/api-and-usage.adoc#organizing[Organizing Fixture scripts], below.
+<2> if the same fixture script (class) is encountered more than once, then run anyway; more on this in xref:ext-fixtures:ROOT:about/api-and-usage.adoc#organizing[Organizing Fixture scripts], below.
<3> specify the fixture script class to provide as the default for the service's "run fixture script" action
<4> whether the service's "run fixture script" action should display other fixture scripts using a choices drop down or (if there are very many of them) using an auto-complete
<5> if present, enables a "recreate objects and return first" action to be displayed in the UI
diff --git a/extensions/specsupport/_adoc/modules/ROOT/nav.adoc b/extensions/specsupport/_adoc/modules/ROOT/nav.adoc
index 2815342..5df99fd 100644
--- a/extensions/specsupport/_adoc/modules/ROOT/nav.adoc
+++ b/extensions/specsupport/_adoc/modules/ROOT/nav.adoc
@@ -1,2 +1,2 @@
-* xref:about.adoc[About]
+include::testing:ROOT:partial$nav.adoc[]
diff --git a/extensions/specsupport/_adoc/modules/ROOT/pages/about.adoc b/extensions/specsupport/_adoc/modules/ROOT/pages/about.adoc
index 004fc71..cde0219 100644
--- a/extensions/specsupport/_adoc/modules/ROOT/pages/about.adoc
+++ b/extensions/specsupport/_adoc/modules/ROOT/pages/about.adoc
@@ -1,6 +1,17 @@
-= Spec Support Extension
+= BDD Spec Support
:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
include::_attributes.adoc[]
-TODO: v2: placeholder for documentation about extensions/specsupport
+link:http://en.wikipedia.org/wiki/Behavior-driven_development[Behaviour-driven design] (BDD) redefines testing not as an after-the-fact "let's check the system works", but rather as a means to work with the domain expert to (a) specify the behaviour of the feature _before_ starting implementation, and (b) provide a means that the domain expert can verify the feature after it has been implemented.
+
+Since domain experts are usually non-technical (at least, they are unlikely to be able to read or want to learn how to read JUnit/Java code), then applying BDD typically requires writing specifications in using structured English text and (ASCII) tables. The BDD tooling parses this text and uses it to actually interact with the system under test. As a byproduct the BDD frameworks generate readable output of some form; this is often an annotated version of the original specification, ma [...]
+
+There are many BDD tools out there; Apache Isis provides an integration with link:https://cucumber.io/docs/reference/jvm#java[Cucumber JVM] (see also the https://github.com/cucumber/cucumber-jvm[github site]):
+
+
+
+
+include::bdd-spec-support/how-it-works.adoc[leveloffset=+1]
+include::bdd-spec-support/writing-a-bdd-spec.adoc[leveloffset=+1]
+include::bdd-spec-support/maven-configuration.adoc[leveloffset=+1]
diff --git a/extensions/specsupport/_adoc/modules/ROOT/pages/_partials/_attributes.adoc b/extensions/specsupport/_adoc/modules/ROOT/pages/bdd-spec-support/_attributes.adoc
similarity index 100%
rename from extensions/specsupport/_adoc/modules/ROOT/pages/_partials/_attributes.adoc
rename to extensions/specsupport/_adoc/modules/ROOT/pages/bdd-spec-support/_attributes.adoc
diff --git a/core/testsupport/_adoc/modules/ROOT/pages/bdd-spec-support/how-it-works.adoc b/extensions/specsupport/_adoc/modules/ROOT/pages/bdd-spec-support/how-it-works.adoc
similarity index 100%
rename from core/testsupport/_adoc/modules/ROOT/pages/bdd-spec-support/how-it-works.adoc
rename to extensions/specsupport/_adoc/modules/ROOT/pages/bdd-spec-support/how-it-works.adoc
diff --git a/core/testsupport/_adoc/modules/ROOT/pages/bdd-spec-support/maven-configuration.adoc b/extensions/specsupport/_adoc/modules/ROOT/pages/bdd-spec-support/maven-configuration.adoc
similarity index 100%
rename from core/testsupport/_adoc/modules/ROOT/pages/bdd-spec-support/maven-configuration.adoc
rename to extensions/specsupport/_adoc/modules/ROOT/pages/bdd-spec-support/maven-configuration.adoc
diff --git a/core/testsupport/_adoc/modules/ROOT/pages/bdd-spec-support/writing-a-bdd-spec.adoc b/extensions/specsupport/_adoc/modules/ROOT/pages/bdd-spec-support/writing-a-bdd-spec.adoc
similarity index 100%
rename from core/testsupport/_adoc/modules/ROOT/pages/bdd-spec-support/writing-a-bdd-spec.adoc
rename to extensions/specsupport/_adoc/modules/ROOT/pages/bdd-spec-support/writing-a-bdd-spec.adoc
diff --git a/core/testsupport/_adoc/modules/ROOT/pages/bdd-spec-support/_attributes.adoc b/extensions/specsupport/_adoc/modules/ROOT/partials/_attributes.adoc
similarity index 81%
rename from core/testsupport/_adoc/modules/ROOT/pages/bdd-spec-support/_attributes.adoc
rename to extensions/specsupport/_adoc/modules/ROOT/partials/_attributes.adoc
index d011536..e8ada7c 100644
--- a/core/testsupport/_adoc/modules/ROOT/pages/bdd-spec-support/_attributes.adoc
+++ b/extensions/specsupport/_adoc/modules/ROOT/partials/_attributes.adoc
@@ -1,4 +1,4 @@
ifndef::env-site,env-github[]
-:moduledir: ../..
+:moduledir: ..
include::{moduledir}/_attributes.adoc[]
endif::[]