diff --git a/README.md b/README.md
index 4472529105..e8df1bb30d 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,11 @@ Like the other Docker projects, `swarm` follows the "batteries included but remo
 ### Installation
 
 ######1 - Download and install the current source code.
+Ensure you have golang installed (e.g. `apt-get install golang` on Ubuntu).
+You may need to set `$GOPATH`, e.g `mkdir ~/gocode; export GOPATH=~/gocode`.
+
+The install `swarm` binary to your `$GOPATH` directory.
+
 ```sh
 go get -u github.com/docker/swarm
 ```
@@ -26,25 +31,25 @@ This can be achieved by starting Docker with the `-H` flag (e.g. `-H 0.0.0.0:237
 ```bash
 # create a cluster
 $ swarm create
-6856663cdefdec325839a4b7e1de38e8
+6856663cdefdec325839a4b7e1de38e8 # <- this is your unique <cluster_id>
 
 # on each of your nodes, start the swarm agent
 #  <node_ip> doesn't have to be public (eg. 192.168.0.X),
 #  as long as the other nodes can reach it, it is fine.
-$ swarm join --discovery token://6856663cdefdec325839a4b7e1de38e8 --addr=<node_ip:2375>
+$ swarm join --discovery token://<cluster_id> --addr=<node_ip:2375>
 
 # start the manager on any machine or your laptop
-$ swarm manage --discovery token://6856663cdefdec325839a4b7e1de38e8 -H=<swarm_ip:swarm_port>
+$ swarm manage --discovery token://<cluster_id> -H=<swarm_ip:swarm_port>
 
 # use the regular docker cli
 $ docker -H <swarm_ip:swarm_port> info
-$ docker -H <swarm_ip:swarm_port> run ... 
-$ docker -H <swarm_ip:swarm_port> ps 
+$ docker -H <swarm_ip:swarm_port> run ...
+$ docker -H <swarm_ip:swarm_port> ps
 $ docker -H <swarm_ip:swarm_port> logs ...
 ...
 
 # list nodes in your cluster
-$ swarm list --discovery token://6856663cdefdec325839a4b7e1de38e8
+$ swarm list --discovery token://<cluster_id>
 http://<node_ip:2375>
 ```
 
@@ -88,4 +93,3 @@ We welcome pull requests and patches; come say hi on IRC, #docker-swarm on freen
 
 Code and documentation copyright 2014 Docker, inc. Code released under the Apache 2.0 license.
 Docs released under Creative commons.
-