+
From 9d327a18294f98510b85ea20715b995201642eec Mon Sep 17 00:00:00 2001
From: Marcin Grzejszczak
All of Spring Cloud Contract is open source, including the documentation. If you find
-problems with the docs or if you want to improve them, please get
+problems with the docs or if you want to improve them, please get
involved.
diff --git a/reference/html/howto.html b/reference/html/howto.html
index ce0e38f66b..7a8337b08f 100644
--- a/reference/html/howto.html
+++ b/reference/html/howto.html
@@ -177,7 +177,7 @@ the spring-cloud-contract tag).
We are also more than happy to extend this section. If you want to add a “how-to”,
-send us a pull request.
+send us a pull request.
diff --git a/reference/html/maven-project.html b/reference/html/maven-project.html
index 5e39802736..3bccb63736 100644
--- a/reference/html/maven-project.html
+++ b/reference/html/maven-project.html
@@ -164,6 +164,9 @@ following sections:
+
+You can also check the plugin’s documentation here.
+
@@ -876,7 +879,7 @@ or an environment variable.
-
+
diff --git a/reference/html/project-features.html b/reference/html/project-features.html
index e532a868bd..ca29df34df 100644
--- a/reference/html/project-features.html
+++ b/reference/html/project-features.html
@@ -8960,7 +8960,7 @@ as follows:
If you want to learn more about any of the classes discussed in this section, you can browse the
-source code directly. If you have specific questions, see the
+source code directly. If you have specific questions, see the
how-to section.
diff --git a/reference/htmlsingle/index.html b/reference/htmlsingle/index.html
index 826111ae1b..d2aab95e06 100644
--- a/reference/htmlsingle/index.html
+++ b/reference/htmlsingle/index.html
@@ -482,13 +482,13 @@ as a map for the rest of the document.
@@ -533,7 +533,7 @@ tagged with
All of Spring Cloud Contract is open source, including the documentation. If you find
-problems with the docs or if you want to improve them, please get
+problems with the docs or if you want to improve them, please get
involved.
@@ -12587,7 +12587,7 @@ as follows:
4.8. What to Read Next
If you want to learn more about any of the classes discussed in this section, you can browse the
-source code directly. If you have specific questions, see the
+source code directly. If you have specific questions, see the
how-to section.
@@ -12614,7 +12614,7 @@ the spring-cloud-contract tag).
We are also more than happy to extend this section. If you want to add a “how-to”,
-send us a pull request.
+send us a pull request.
5.1. Why use Spring Cloud Contract?
diff --git a/reference/pdf/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache b/reference/pdf/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache
new file mode 100644
index 0000000000..ca8988965c
--- /dev/null
+++ b/reference/pdf/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache
@@ -0,0 +1 @@
+{"checksum":"23a7e5a52b04e1a55f2d102255d7ea04","width":886,"height":676}
\ No newline at end of file
diff --git a/reference/pdf/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache b/reference/pdf/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache
new file mode 100644
index 0000000000..a17e22fcb1
--- /dev/null
+++ b/reference/pdf/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache
@@ -0,0 +1 @@
+{"checksum":"c9ffba1bc9383435e35a7973e5641dd8","width":1213,"height":1341}
\ No newline at end of file
diff --git a/reference/pdf/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache b/reference/pdf/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache
new file mode 100644
index 0000000000..2f99cba6c4
--- /dev/null
+++ b/reference/pdf/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache
@@ -0,0 +1 @@
+{"checksum":"30b3d3322b3ecb24a6c5346a8571ba98","width":815,"height":618}
\ No newline at end of file
diff --git a/reference/pdf/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache b/reference/pdf/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache
new file mode 100644
index 0000000000..5a3310d3c6
--- /dev/null
+++ b/reference/pdf/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache
@@ -0,0 +1 @@
+{"checksum":"37241bc45c73dbad7383a4733a05d559","width":930,"height":810}
\ No newline at end of file
diff --git a/reference/pdf/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache b/reference/pdf/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache
new file mode 100644
index 0000000000..2d6b2f9d08
--- /dev/null
+++ b/reference/pdf/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache
@@ -0,0 +1 @@
+{"checksum":"b137ec966db7960885422f991695d28f","width":783,"height":677}
\ No newline at end of file
diff --git a/reference/pdf/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache b/reference/pdf/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache
new file mode 100644
index 0000000000..eac3cd74e2
--- /dev/null
+++ b/reference/pdf/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache
@@ -0,0 +1 @@
+{"checksum":"a46f733654d99c8861184f0e4e04bb95","width":590,"height":685}
\ No newline at end of file
diff --git a/reference/pdf/.asciidoctor/diagram/getting-started-cdc-client.png.cache b/reference/pdf/.asciidoctor/diagram/getting-started-cdc-client.png.cache
new file mode 100644
index 0000000000..89ce0d961d
--- /dev/null
+++ b/reference/pdf/.asciidoctor/diagram/getting-started-cdc-client.png.cache
@@ -0,0 +1 @@
+{"checksum":"b1418561d3b01d5d71885b4b7bb1be93","width":1138,"height":1223}
\ No newline at end of file
diff --git a/reference/pdf/.asciidoctor/diagram/getting-started-cdc-server.png.cache b/reference/pdf/.asciidoctor/diagram/getting-started-cdc-server.png.cache
new file mode 100644
index 0000000000..0b7b2d7806
--- /dev/null
+++ b/reference/pdf/.asciidoctor/diagram/getting-started-cdc-server.png.cache
@@ -0,0 +1 @@
+{"checksum":"7a8cb19e9d604071d61e4aa9201ee623","width":688,"height":903}
\ No newline at end of file
diff --git a/reference/pdf/.asciidoctor/diagram/getting-started-three-second.png.cache b/reference/pdf/.asciidoctor/diagram/getting-started-three-second.png.cache
new file mode 100644
index 0000000000..3e5f4a8ff5
--- /dev/null
+++ b/reference/pdf/.asciidoctor/diagram/getting-started-three-second.png.cache
@@ -0,0 +1 @@
+{"checksum":"27396daead141eee677aa6311403d175","width":986,"height":704}
\ No newline at end of file
diff --git a/reference/pdf/.asciidoctor/diagram/how-to-common-repo.png.cache b/reference/pdf/.asciidoctor/diagram/how-to-common-repo.png.cache
new file mode 100644
index 0000000000..c23499f956
--- /dev/null
+++ b/reference/pdf/.asciidoctor/diagram/how-to-common-repo.png.cache
@@ -0,0 +1 @@
+{"checksum":"89bbfd25e4c214245543ed34208e2afa","width":1588,"height":1421}
\ No newline at end of file
diff --git a/reference/pdf/.asciidoctor/diagram/rest-docs.png.cache b/reference/pdf/.asciidoctor/diagram/rest-docs.png.cache
new file mode 100644
index 0000000000..74da30c065
--- /dev/null
+++ b/reference/pdf/.asciidoctor/diagram/rest-docs.png.cache
@@ -0,0 +1 @@
+{"checksum":"e3500a52c420af0a5337450779a25536","width":1237,"height":835}
\ No newline at end of file
diff --git a/reference/pdf/images/flow-overview-consumer-cdc-external-consumer.png b/reference/pdf/images/flow-overview-consumer-cdc-external-consumer.png
new file mode 100644
index 0000000000000000000000000000000000000000..6304c4a33d763650066de3dfe85d2afc7d06ed10
GIT binary patch
literal 38637
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
literal 0
HcmV?d00001
diff --git a/reference/pdf/images/flow-overview-consumer-cdc-external-producer.png b/reference/pdf/images/flow-overview-consumer-cdc-external-producer.png
new file mode 100644
index 0000000000000000000000000000000000000000..df52a241142e937f992547d695e11cf8a464d5b2
GIT binary patch
literal 78892
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