From d2b6522ce9743637c830fc040b1720cc6c6f11d2 Mon Sep 17 00:00:00 2001
From: Andrea Luzzardi <aluzzardi@gmail.com>
Date: Thu, 4 Dec 2014 12:35:30 -0800
Subject: [PATCH] Add a README file for discovery explaining the API.

---
 discovery/README.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 discovery/README.md

diff --git a/discovery/README.md b/discovery/README.md
new file mode 100644
index 0000000000..6f1aad7274
--- /dev/null
+++ b/discovery/README.md
@@ -0,0 +1,26 @@
+#discovery.hub.docker.com
+
+Docker Swarm comes with a simple discovery service built into the [Docker Hub](http://hub.docker.com)
+
+The discovery service is still in alpha stage and currently hosted at `http://discovery-stage.hub.docker.com`
+
+#####Create a new cluster
+`-> POST http://discovery.hub.docker.com/v1/clusters (data="")`
+`<- <token>`
+
+#####Add new nodes to a cluster
+`-> POST http://discovery.hub.docker.com/v1/clusters/<token> (data="<ip:port1>")`
+`<- OK`
+
+`-> POST http://discovery.hub.docker.com/v1/clusters/token (data="<ip:port2>")`
+`<- OK`
+
+
+#####List nodes in a cluster
+`-> GET http://discovery.hub.docker.com/v1/clusters/token`
+`<- ["<ip:port1>", "<ip:port2>"]`
+
+
+#####Delete a cluster (all the nodes in a cluster)
+`-> DELETE http://discovery.hub.docker.com/v1/clusters/token`
+`<- OK`