diff --git a/docs/src/main/asciidoc/getting-started.adoc b/docs/src/main/asciidoc/getting-started.adoc
index e62c0f5f..771cb0a0 100644
--- a/docs/src/main/asciidoc/getting-started.adoc
+++ b/docs/src/main/asciidoc/getting-started.adoc
@@ -7,6 +7,9 @@ provide implementations using the https://github.com/fabric8io/kubernetes-client
 Starters that begin with
 `spring-cloud-starter-kubernetes-client` provide implementations using the https://github.com/kubernetes-client/java[Kubernetes Java Client].
 
+NOTE:  You CANNOT combine starters from Fabric8 and Kubernetes Java Clients.  You must pick one library to
+use and use the starters for that library only.
+
 [cols="a,d"]
 |===
 | Starter | Features