diff --git a/README.adoc b/README.adoc
index b2f3292d59..c4288d00f7 100644
--- a/README.adoc
+++ b/README.adoc
@@ -5,7 +5,7 @@ image::https://badges.gitter.im/Join%20Chat.svg[Gitter, link="https://gitter.im/
 image::https://codecov.io/gh/spring-cloud/spring-cloud-contract/branch/{branch}/graph/badge.svg["codecov", link="https://codecov.io/gh/spring-cloud/spring-cloud-contract"]
 image::https://circleci.com/gh/spring-cloud/spring-cloud-contract.svg?style=svg["CircleCI", link="https://circleci.com/gh/spring-cloud/spring-cloud-contract"]
 :introduction_url: ../../../..
-:verifier_core_path: ../../../../spring-cloud-contract-verifier
+:verifier_core_path: {introduction_url}/spring-cloud-contract-verifier
 
 == Spring Cloud Contract
 
@@ -1137,6 +1137,7 @@ Next, add the `Spring Cloud Contract Verifier` Maven plugin
     <extensions>true</extensions>
     <configuration>
         <packageWithBaseClasses>com.example.fraud</packageWithBaseClasses>
+        <convertToYaml>true</convertToYaml>
     </configuration>
 </plugin>
 ----
@@ -1304,6 +1305,7 @@ In the configuration of the Maven plugin, pass the `packageWithBaseClasses` prop
     <extensions>true</extensions>
     <configuration>
         <packageWithBaseClasses>com.example.fraud</packageWithBaseClasses>
+        <convertToYaml>true</convertToYaml>
     </configuration>
 </plugin>
 ----
diff --git a/docs/src/main/asciidoc/spring-cloud-contract-verifier.adoc b/docs/src/main/asciidoc/spring-cloud-contract-verifier.adoc
index 21183b4e5f..8f6b26b316 100644
--- a/docs/src/main/asciidoc/spring-cloud-contract-verifier.adoc
+++ b/docs/src/main/asciidoc/spring-cloud-contract-verifier.adoc
@@ -11,7 +11,8 @@
 :standalone_pact_path: {samples_path}/standalone/pact
 :standalone_restdocs_path: {samples_path}/standalone/restdocs
 :tests_path: {core_path}/tests
-:samples_url: https://raw.githubusercontent.com/spring-cloud-samples/spring-cloud-contract-samples/master
+:samples_branch: 2.1.x
+:samples_url: https://raw.githubusercontent.com/spring-cloud-samples/spring-cloud-contract-samples/{samples_branch}
 :introduction_url: ${core_path}/../../
 
 include::verifier_introduction.adoc[]