diff --git a/README.md b/README.md
index 0878b7d..a95f13f 100644
--- a/README.md
+++ b/README.md
@@ -1,17 +1,26 @@
-Instavote
+Example Voting App
 =========
 
 Getting started
 ---------------
 
-Download [Docker for Mac or Windows](https://www.docker.com).
+Download [Docker](https://www.docker.com/products/overview). If you are on Mac or Windows, [Docker Compose](https://docs.docker.com/compose) will be automatically installed. On Linux, make sure you have the latest version of [Compose](https://docs.docker.com/compose/install/).
 
 Run in this directory:
-
-    $ docker-compose up
-
+```
+docker-compose up
+```
 The app will be running at [http://localhost:5000](http://localhost:5000), and the results will be at [http://localhost:5001](http://localhost:5001).
 
+Alternately, if you want to run it on a [Docker Swarm](https://docs.docker.com/engine/swarm/), first make sure you have a swarm. If you don't, run:
+```
+docker swarm init
+```
+Once you have your swarm, in this directory run:
+```
+docker stack deploy --compose-file docker-stack.yml vote
+```
+
 Architecture
 -----
 
diff --git a/docker-compose-javaworker.yml b/docker-compose-javaworker.yml
index a35458b..df9f117 100644
--- a/docker-compose-javaworker.yml
+++ b/docker-compose-javaworker.yml
@@ -1,4 +1,4 @@
-version: "2"
+version: "3"
 
 services:
   vote:
diff --git a/docker-compose-simple.yml b/docker-compose-simple.yml
index 289b9d2..aef4b75 100644
--- a/docker-compose-simple.yml
+++ b/docker-compose-simple.yml
@@ -1,4 +1,4 @@
-version: "2"
+version: "3"
 
 services:
   vote:
diff --git a/docker-compose.yml b/docker-compose.yml
index efc3e6f..c5460ee 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,4 +1,4 @@
-version: "2"
+version: "3"
 
 services:
   vote: