diff --git a/src/main/asciidoc/dependencies.adoc b/src/main/asciidoc/dependencies.adoc
index 86724e440..1586cf3d8 100644
--- a/src/main/asciidoc/dependencies.adoc
+++ b/src/main/asciidoc/dependencies.adoc
@@ -21,7 +21,8 @@ Due to different inception dates of individual Spring Data modules, most of them
----
====
-The current release train version is {releasetrainVersion}. The train names are ascending alphabetically and currently available ones are listed https://github.com/spring-projects/spring-data-commons/wiki/Release-planning[here]. The version name follows the following pattern: `${name}-${release}` where release can be one of the following:
+[[dependencies.train-names]]
+The current release train version is `{releasetrainVersion}. The train names are ascending alphabetically and currently available ones are listed https://github.com/spring-projects/spring-data-commons/wiki/Release-planning[here]. The version name follows the following pattern: `${name}-${release}` where release can be one of the following:
* `BUILD-SNAPSHOT` - current snapshots
* `M1`, `M2` etc. - milestones
@@ -29,9 +30,7 @@ The current release train version is {releasetrainVersion}. The train names are
* `RELEASE` - GA release
* `SR1`, `SR2` etc. - service releases
-A working example of using the BOMs can be found in our https://github.com/spring-projects/spring-data-examples/tree/master/bom[Spring Data examples repository].
-
-If that's in place declare the Spring Data modules you'd like to use without a version in the `` block.
+A working example of using the BOMs can be found in our https://github.com/spring-projects/spring-data-examples/tree/master/bom[Spring Data examples repository]. If that's in place declare the Spring Data modules you'd like to use without a version in the `` block.
.Declaring a dependency to a Spring Data module
====
@@ -49,9 +48,10 @@ If that's in place declare the Spring Data modules you'd like to use without a v
[[dependencies.spring-boot]]
== Dependency management with Spring Boot
-Spring Boot already selects a very recent version of Spring Data modules for you. In case you want to upgrade to a newer version nonetheless, simply configure the property `spring-data-releasetrain.version` to the train name and iteration you'd like to use.
+Spring Boot already selects a very recent version of Spring Data modules for you. In case you want to upgrade to a newer version nonetheless, simply configure the property `spring-data-releasetrain.version` to the <> you'd like to use.
[[dependencies.spring-framework]]
== Spring Framework
The current version of Spring Data modules require Spring Framework in version {springVersion} or better. The modules might also work with an older bugfix version of that minor version. However, using the most recent version within that generation is highly recommended.
+
diff --git a/src/main/asciidoc/repositories.adoc b/src/main/asciidoc/repositories.adoc
index 127fab5ff..f4c9977ea 100644
--- a/src/main/asciidoc/repositories.adoc
+++ b/src/main/asciidoc/repositories.adoc
@@ -1,6 +1,5 @@
:spring-framework-docs: http://docs.spring.io/spring/docs/current/spring-framework-reference/html
-
[[repositories]]
= Working with Spring Data Repositories