diff --git a/discovery/token/README.md b/discovery/token/README.md
index 5244994852..99e0cc4880 100644
--- a/discovery/token/README.md
+++ b/discovery/token/README.md
@@ -5,27 +5,27 @@ Docker Swarm comes with a simple discovery service built into the [Docker Hub](h
 The discovery service is still in alpha stage and currently hosted at `https://discovery-stage.hub.docker.com`
 
 #####Create a new cluster
-`-> POST https://discovery.hub.docker.com/v1/clusters (data="")`
+`-> POST https://discovery-stage.hub.docker.com/v1/clusters`
 
 `<- <token>`
 
 #####Add new nodes to a cluster
-`-> POST https://discovery.hub.docker.com/v1/clusters/<token> (data="<ip:port1>")`
+`-> POST https://discovery-stage.hub.docker.com/v1/clusters/<token> (data="<ip:port1>")`
 
 `<- OK`
 
-`-> POST https://discovery.hub.docker.com/v1/clusters/token (data="<ip:port2>")`
+`-> POST https://discovery-stage.hub.docker.com/v1/clusters/<token> (data="<ip:port2>")`
 
 `<- OK`
 
 
 #####List nodes in a cluster
-`-> GET https://discovery.hub.docker.com/v1/clusters/token`
+`-> GET https://discovery-stage.hub.docker.com/v1/clusters/<token>`
 
 `<- ["<ip:port1>", "<ip:port2>"]`
 
 
 #####Delete a cluster (all the nodes in a cluster)
-`-> DELETE https://discovery.hub.docker.com/v1/clusters/token`
+`-> DELETE https://discovery-stage.hub.docker.com/v1/clusters/<token>`
 
 `<- OK`
diff --git a/scheduler/filter/README.md b/scheduler/filter/README.md
index 2ab36a912d..d33581c63a 100644
--- a/scheduler/filter/README.md
+++ b/scheduler/filter/README.md
@@ -8,12 +8,12 @@ page_keywords: docker, swarm, clustering, filters
 
 The `Docker Swarm` scheduler comes with multiple filters.
 
-These filters are used to schedule containers on a subset of nodes.
+The following filters are currently used to schedule containers on a subset of nodes:
 
-`Docker Swarm` currently supports 4 filters:
 * [Constraint](#constraint-filter)
 * [Affinity](#affinity-filter)
 * [Port](#port-filter)
+* [Dependency](#dependency-filter)
 * [Health](#health-filter)
 
 You can choose the filter(s) you want to use with the `--filter` flag of `swarm manage`