Doc 1.0.x client override

Author: garyrussell

src/reference/asciidoc/appendix.adoc

@@ -1,4 +1,53 @@
+[[deps-for-10x]]
+== Override Dependencies to use the 1.0.x kafka-clients
+
+When using `spring-kafka-test` (_version 1.3.x_, starting with _version 1.3.5_) with the 1.0.x `kafka-clients` jar, you will need to override certain transitive dependencies as follows:
+
+[source, xml]
+----
+<dependency>
+    <groupId>org.springframework.kafka</groupId>
+    <artifactId>spring-kafka</artifactId>
+    <version>${spring.kafka.version}</version>
+</dependency>
+
+<dependency>
+    <groupId>org.springframework.kafka</groupId>
+    <artifactId>spring-kafka-test</artifactId>
+    <version>${spring.kafka.version}</version>
+    <scope>test</scope>
+</dependency>
+
+<dependency>
+    <groupId>org.apache.kafka</groupId>
+    <artifactId>kafka-clients</artifactId>
+    <version>1.0.1</version>
+</dependency>
+
+<dependency>
+    <groupId>org.apache.kafka</groupId>
+    <artifactId>kafka-clients</artifactId>
+    <version>1.0.1</version>
+    <classifier>test</classifier>
+</dependency>
+
+<dependency>
+    <groupId>org.apache.kafka</groupId>
+    <artifactId>kafka_2.11</artifactId>
+    <version>1.0.1</version>
+    <scope>test</scope>
+</dependency>
+
+<dependency>
+    <groupId>org.apache.kafka</groupId>
+    <artifactId>kafka_2.11</artifactId>
+    <version>1.0.1</version>
+    <classifier>test</classifier>
+    <scope>test</scope>
+</dependency>
+----
+
 [[history]]
 == Change History
 
-include::./changes-1.0-1.1.adoc[]
+include::./changes-1.0-1.1.adoc[]