diff --git a/docs/src/docs/asciidoc/index.adoc b/docs/src/docs/asciidoc/index.adoc
index c8973969..2f34078d 100644
--- a/docs/src/docs/asciidoc/index.adoc
+++ b/docs/src/docs/asciidoc/index.adoc
@@ -25,11 +25,11 @@ If you are using alternative build systems, see <<alternative-build-systems.adoc
 
 ==== Gradle plugin
 
-- Update plugin to use metadata repository by default
+- Update plugin to use metadata repository by default. Metadata repository <<gradle-plugin.adoc#_configuring_the_metadata_repository,can be disabled manually.>>
 
-====Maven plugin
+==== Maven plugin
 
-- Update plugin to use metadata repository by default
+- Update plugin to use metadata repository by default. Metadata repository <<maven-plugin.adoc#_configuring_the_metadata_repository,can be disabled manually.>>
 
 
 === Release 0.9.28