diff --git a/discovery/README.md b/discovery/README.md
index c7862fb83b..6db76131e4 100644
--- a/discovery/README.md
+++ b/discovery/README.md
@@ -10,8 +10,19 @@ Docker Swarm comes with multiple Discovery backends.
 
 ## Backends
 
+You use a hosted discovery service with Docker Swarm. The service
+maintains a list of IPs in your swam. There are several available
+services, such as `etcd`, `consul` and `zookeeper` depending on what
+is best suited for your environment. You can even use a static
+file. Docker Hub also provides a hosted discovery service which you
+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
+swarm is connected to the internet. To create your swarm:
+
 First we create a cluster.
 
 ```bash
diff --git a/docs/discovery.md b/docs/discovery.md
index f208e2f79b..ca6de0c96f 100644
--- a/docs/discovery.md
+++ b/docs/discovery.md
@@ -15,8 +15,19 @@ Docker Swarm comes with multiple Discovery backends.
 
 ## Backends
 
+You use a hosted discovery service with Docker Swarm. The service
+maintains a list of IPs in your swam. There are several available
+services, such as `etcd`, `consul` and `zookeeper` depending on what
+is best suited for your environment. You can even use a static
+file. Docker Hub also provides a hosted discovery service which you
+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
+swarm is connected to the internet. To create your swarm:
+
 First we create a cluster.
 
     # create a cluster