Update readme

Author: ebeigarts

README.md

@@ -1,16 +1,22 @@
 # Deployer
 
-Deploy dokku application using GitHub Deployments
+Deploy [dokku](http://dokku.viewdocs.io/dokku/) applications using [GitHub Deployments](https://developer.github.com/v3/repos/deployments/).
 
-1. Listen to new GitHub deployments
+1. Listen/poll new GitHub deployments
 2. Create pending GitHub deployment status and empty Gist
 3. Deploy application to dokku
 4. Create success/failure Github deployment status and update Gist
-5. Sleep
+5. Sleep 30 seconds
 6. Go to step #1
 
 Make sure to run `deployer` as `dokku` user.
 
+To register github deployments you can use [deploy](https://github.com/remind101/deploy),
+[slashdeploy](https://github.com/remind101/slashdeploy) or something else.
+
+If you are using Slack, you can enable 'Deploy Events -> Show deployment statuses'
+to get slack notifications with links to Gist.
+
 ## Usage
 
 ```bash
@@ -34,6 +40,44 @@ deployer -h
     	GitHub username (required)
 ```
 
+## Example
+
+Trigger deployment from developer's machine:
+
+```bash
+$ cd ~/src/myapp
+$ deploy --branch v49.3 --env demo
+```
+
+On the dokku server:
+
+```bash
+$ deployer -u ghuser -p ghpass -org mak-it -repo myapp -env demo -app myapp-demo -sleep 30
+```
+
+Output:
+
+```
+Deployer
+ghuser ghpass mak-it myapp demo myapp-demo
+Sleep duration: 30s
+2017/08/24 13:31:43 Cloning repo  
+2017/08/24 13:31:51 Adding repo dokku remote  .myapp-demo myapp-demo
+2017/08/24 13:32:52 Getting deployment  demo
+2017/08/24 13:32:53 Problem in getting deployment Deployment statuses already present
+2017/08/24 13:32:53 Sleeping 30s
+2017/08/24 13:33:23 Getting deployment  demo
+2017/08/24 13:33:23 123 master demo
+2017/08/24 13:33:23 Fetchin repo  .myapp-demo
+2017/08/24 13:33:24 Gist create ID: 123, Ref: v49.3, Environment: demo
+2017/08/24 13:33:25 Gist https://gist.github.com/...
+2017/08/24 13:33:25 Deployment status create  pending
+2017/08/24 13:33:26 Deploying repo  .myapp-demo
+Everything up-to-date
+2017/08/24 13:33:26 Deployment status create  success
+2017/08/24 13:33:26 Gist update
+```
+
 ## Build
 
 ```bash