diff --git a/discovery/README.md b/discovery/README.md
index 51b28f22ec..e705309da2 100644
--- a/discovery/README.md
+++ b/discovery/README.md
@@ -19,8 +19,9 @@ can use.
 
 ### Hosted Discovery with Docker Hub
 
-This example uses the hosted discovery service on Docker Hub. Using
-Docker Hub's hosted discovery service requires that each node in the
+This example uses the hosted discovery service on Docker Hub. It is not
+meant to be used in production scenarios but for development/testing only.
+Using Docker Hub's hosted discovery service requires that each node in the
 swarm is connected to the internet. To create your swarm:
 
 First we create a cluster.
diff --git a/docs/discovery.md b/docs/discovery.md
index eea7d047db..c271e7a3e0 100644
--- a/docs/discovery.md
+++ b/docs/discovery.md
@@ -24,10 +24,10 @@ can use.
 
 ### Hosted Discovery with Docker Hub
 
-#####The Hosted Discovery Service is not recomended for production use.
+#####The Hosted Discovery Service is not recommended for production use.
 #####It's intended to be used for testing/development.
 
-#####See other backends for produtions use cases.
+#####See other discovery backends for production use.
 
 This example uses the hosted discovery service on Docker Hub. Using
 Docker Hub's hosted discovery service requires that each node in the