diff --git a/docs/install.md b/docs/install.md
index 4509822aa..4cc6dae78 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -1,36 +1,44 @@
----
-layout: default
-title: Installing Compose
 page_title: Installing Compose
-page_description: Installing Compose
-page_keywords: fig, composition, compose, docker
----
+page_description: How to intall Docker Compose
+page_keywords: compose, orchestration, install, installation, docker, documentation
 
-# Installing Compose
 
-First, install Docker version 1.3 or greater.
+## Installing Compose
 
-If you're on OS X, you can use the [OS X installer](https://docs.docker.com/installation/mac/)
-to install both Docker and boot2docker. Once boot2docker is running, set the environment
-variables that'll configure Docker and Compose to talk to it:
+To install Compose, you'll need to install Docker first. You'll then install
+Compose with a `curl` command. 
+
+### Install Docker
+
+First, you'll need to install Docker version 1.3 or greater.
+
+If you're on OS X, you can use the
+[OS X installer](https://docs.docker.com/installation/mac/) to install both
+Docker and the OSX helper app, boot2docker. Once boot2docker is running, set the
+environment variables that'll configure Docker and Compose to talk to it:
 
     $(boot2docker shellinit)
 
-To persist the environment variables across shell sessions, you can add that line
+To persist the environment variables across shell sessions, add the above line
 to your `~/.bashrc` file.
 
-There are also guides for [Ubuntu](https://docs.docker.com/installation/ubuntulinux/)
-and [other platforms](https://docs.docker.com/installation/) in Docker`s documentation.
+For complete instructions, or if you are on another platform, consult Docker's
+[installation instructions](https://docs.docker.com/installation/).
 
-Next, install Compose:
+### Install Compose
 
-    curl -L https://github.com/docker/fig/releases/download/1.1.0-rc2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose; chmod +x /usr/local/bin/docker-compose
+To install Compose, run the following commands:
 
-Optionally, install [command completion](completion.html) for the bash shell.
+    curl -L https://github.com/docker/docker-compose/releases/download/1.1.0-rc2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
+    chmod +x /usr/local/bin/docker-compose
 
-Releases are available for OS X and 64-bit Linux. Compose is also available as a Python
-package if you're on another platform (or if you prefer that sort of thing):
+Optionally, you can also install [command completion](completion.html) for the
+bash shell.
+
+Compose is available for OS X and 64-bit Linux. If you're on another platform,
+Compose can also be installed as a Python package:
 
     $ sudo pip install -U docker-compose
 
-That should be all you need! Run `docker-compose --version` to see if it worked.
+No further steps are required; Compose should now be successfully  installed.
+You can test the installation by running `docker-compose --version`.