diff --git a/docs/discovery.md b/docs/discovery.md
index 576c8ea826..eea7d047db 100644
--- a/docs/discovery.md
+++ b/docs/discovery.md
@@ -24,6 +24,11 @@ can use.
 
 ### Hosted Discovery with Docker Hub
 
+#####The Hosted Discovery Service is not recomended for production use.
+#####It's intended to be used for testing/development.
+
+#####See other backends for produtions use cases.
+
 This example uses the hosted discovery service on Docker Hub. Using
 Docker Hub's hosted discovery service requires that each node in the
 swarm is connected to the internet. To create your swarm:
diff --git a/docs/install-manual.md b/docs/install-manual.md
index 24ac5070f1..494912c87f 100644
--- a/docs/install-manual.md
+++ b/docs/install-manual.md
@@ -51,7 +51,8 @@ The easiest way to get started with Swarm is to use the
 Each Swarm node will run a Swarm node agent. The agent registers the referenced
 Docker daemon, monitors it, and updates the discovery backend with the node's status.
 
-This example uses the Docker Hub based `token` discovery service. Log into **each node** and do the following.
+This example uses the Docker Hub based `token` discovery service (only for testing/dev, not for production).
+Log into **each node** and do the following.
 
 1. Start the Docker daemon with the `-H` flag. This ensures that the
 Docker remote API on *Swarm Agents* is available over TCP for the
diff --git a/docs/install-w-machine.md b/docs/install-w-machine.md
index 93240c9c64..c777b4ab85 100644
--- a/docs/install-w-machine.md
+++ b/docs/install-w-machine.md
@@ -32,10 +32,10 @@ containers. Docker Machine manages all this provisioning for your swarm.
 
 Before you create a swarm with `docker-machine`, you associate each
 node with a discovery service. This example uses the token discovery
-service hosted by Docker Hub. This discovery service associates a
-token with instances of the Docker Daemon running on each node. Other
-discovery service backends such as `etcd`, `consul`, and `zookeeper`
-are [available](discovery.md).
+service hosted by Docker Hub (only for testing/dev, not for production).
+This discovery service associates a token with instances of the Docker
+Daemon running on each node. Other discovery service backends such as
+`etcd`, `consul`, and `zookeeper` are [available](discovery.md).
 
 1. List the machines on your system.