diff --git a/docs/src/docs/asciidoc/stubrunner.adoc b/docs/src/docs/asciidoc/stubrunner.adoc
index c5a0a1d6be..a053d396a4 100644
--- a/docs/src/docs/asciidoc/stubrunner.adoc
+++ b/docs/src/docs/asciidoc/stubrunner.adoc
@@ -56,4 +56,18 @@ Some of the properties that are repetitive can be set using system properties or
 |stubrunner.stubs.classifier|stubs| Default classifier for the stub artifacts|
 |stubrunner.work-offline|false| If true then will not contact any remote repositories to download stubs|
 |stubrunner.stubs|| Comma separated list of Ivy notation of stubs to download|
-|======================
\ No newline at end of file
+|======================
+
+===== Stub runner stubs ids
+
+You can provide the stubs to download via the `stubrunner.stubs.ids` system property. They follow the following pattern:
+
+[source,java,indent=0]
+----
+groupId:artifactId:classifier:port
+----
+
+`classifier` and `port` are optional.
+
+* If you don't provide the `classifier` then the default one will be taken.
+* If you don't provide the `port` then a random one will be picked
\ No newline at end of file
diff --git a/stub-runner/stub-runner-junit/README.adoc b/stub-runner/stub-runner-junit/README.adoc
index 8a512100ac..a4e3d5636d 100644
--- a/stub-runner/stub-runner-junit/README.adoc
+++ b/stub-runner/stub-runner-junit/README.adoc
@@ -43,21 +43,8 @@ Check the *Common properties for JUnit and Spring* for more information on how t
 
 ==== Providing fixed ports
 
-You can also run your stubs on fixed ports. You can do it in two different ways. One is to pass it in the properties, and the other via fluent API.
-
-===== System properties
-
-You can provide the stubs to download via the `stubrunner.stubs.ids` system property. They follow the following pattern:
-
-[source,java,indent=0]
-----
-groupId:artifactId:classifier:port
-----
-
-`classifier` and `port` are optional.
-
-* If you don't provide the `classifier` then the default one will be taken.
-* If you don't provide the `port` then a random one will be picked
+You can also run your stubs on fixed ports. You can do it in two different ways. One is to pass it in the properties, and the other via fluent API of
+JUnit rule.
 
 ==== Fluent API