diff --git a/docs/sources/docker-hub/builds.md b/docs/sources/docker-hub/builds.md
index 9c30951ebc..e4d64eb28e 100644
--- a/docs/sources/docker-hub/builds.md
+++ b/docs/sources/docker-hub/builds.md
@@ -77,13 +77,16 @@ Automated Build:
1. |
- ![](https://d207aa93qlcgug.cloudfront.net/0.8/img/github_settings.png) |
- Log in to Github.com, and visit your Repository page. Click on repository "Settings" on the right side of the page. You must have admin privileges to the repository in order to do this. |
+ ![](/docker-hub/hub-images/gh_settings.png) |
+ Log in to Github.com, and go to your Repository page. Click on "Settings" on
+ the right side of the page. You must have admin privileges to the repository in order to do this. |
2. |
- ![Service Hooks](https://d207aa93qlcgug.cloudfront.net/0.8/img/github_service_hooks.png) |
- Click on "Webhooks & Services" on the left side of the page. |
3. | ![Find the service labeled Docker](https://d207aa93qlcgug.cloudfront.net/0.8/img/github_docker_service_hook.png) | Find the service labeled "Docker" and click on it. |
4. | ![Activate Service Hooks](https://d207aa93qlcgug.cloudfront.net/0.8/img/github_service_hook_docker_activate.png) |
+ ![Webhooks & Services](/docker-hub/hub-images/gh_menu.png) |
+ Click on "Webhooks & Services" on the left side of the page. |
+ 3. | ![Find the service labeled Docker](/docker-hub/hub-images/gh_service_hook.png) | Find the service labeled "Docker" and click on it. |
+ 4. | ![Activate Service Hooks](/docker-hub/hub-images/gh_docker-service.png) |
Make sure the "Active" checkbox is selected and click the "Update service" button to save your changes. |
@@ -112,42 +115,42 @@ public or private Bitbucket repositories with a `Dockerfile`.
## The Dockerfile and Automated Builds
-During the build process, we copy the contents of your `Dockerfile`. We also
-add it to the [Docker Hub](https://hub.docker.com) for the Docker community (for public
-repos) or approved team members/orgs (for private repos) to see on the repository page
-(if your repo is public).
+During the build process, Docker will copy the contents of your `Dockerfile`. It will
+also add it to the [Docker Hub](https://hub.docker.com) for the Docker community (for
+public repos) or approved team members/orgs (for private repos) to see on the repository
+page.
## README.md
If you have a `README.md` file in your repository, it will be used as the
-repository's full description.
+repository's full description.The build process will look for a
+`README.md` in the same directory as your `Dockerfile`.
> **Warning:**
> If you change the full description after a build, it will be
> rewritten the next time the Automated Build has been built. To make changes,
-> modify the `README.md` from the Git repository. The build process will look for a
-> `README.md` in the same directory as your `Dockerfile`.
+> modify the `README.md` from the Git repository.
### Build triggers
If you need a way to trigger Automated Builds outside of GitHub
or Bitbucket, you can set up a build trigger. When you turn on the build
trigger for an Automated Build, it will give you a URL to which you can
-send POST requests. This will trigger the Automated Build, which
-is similar to GitHub webhooks.
+send POST requests. This will trigger the Automated Build, much as with a GitHub webhook.
-Build triggers are available under the Settings tab of each Automated Build.
+Build triggers are available under the Settings menu of each Automated Build repo on the
+Docker Hub.
> **Note:**
> You can only trigger one build at a time and no more than one
-> every five minutes. If you have a build already pending, or if you already
+> every five minutes. If you already have a build pending, or if you
> recently submitted a build request, those requests *will be ignored*.
-> You can find the logs of last 10 triggers on the settings page to verify
-> if everything is working correctly.
+> To verify everything is working correctly, check the logs of last ten triggers on the
+settings page .
### Webhooks
-Also available for Automated Builds are Webhooks. Webhooks can be called
+Automated Builds also include a Webhooks feature. Webhooks can be called
after a successful repository push is made.
The webhook call will generate a HTTP POST with the following JSON
@@ -184,24 +187,23 @@ payload:
}
```
-Webhooks are available under the Settings tab of each Automated
-Build.
+Webhooks are available under the Settings menu of each Automated
+Build's repo.
-> **Note:** If you want to test your webhook out then we recommend using
+> **Note:** If you want to test your webhook out we recommend using
> a tool like [requestb.in](http://requestb.in/).
### Repository links
Repository links are a way to associate one Automated Build with another. If one
-gets updated, linking system also triggers a build for the other Automated Build.
-This makes it easy to keep your Automated Builds up to date.
+gets updated,the linking system triggers a rebuild for the other Automated Build.
+This makes it easy to keep all your Automated Builds up to date.
-To add a link, go to the settings page of an Automated Build and click on
-*Repository Links*. Then enter the name of the repository that you want have
-linked.
+To add a link, go to the repo for the Automated Build you want to link to and click on
+*Repository Links* under the Settings menu at right. Then, enter the name of the repository that you want have linked.
> **Warning:**
> You can add more than one repository link, however, you should
-> be very careful. Creating a two way relationship between Automated Builds will
-> cause a never ending build loop.
+> do so very carefully. Creating a two way relationship between Automated Builds will
+> cause an endless build loop.
diff --git a/docs/sources/docker-hub/hub-images/gh_docker-service.png b/docs/sources/docker-hub/hub-images/gh_docker-service.png
new file mode 100644
index 0000000000..0119b9e22a
Binary files /dev/null and b/docs/sources/docker-hub/hub-images/gh_docker-service.png differ
diff --git a/docs/sources/docker-hub/hub-images/gh_menu.png b/docs/sources/docker-hub/hub-images/gh_menu.png
new file mode 100644
index 0000000000..d9c8d11996
Binary files /dev/null and b/docs/sources/docker-hub/hub-images/gh_menu.png differ
diff --git a/docs/sources/docker-hub/hub-images/gh_service_hook.png b/docs/sources/docker-hub/hub-images/gh_service_hook.png
new file mode 100644
index 0000000000..9a00153bb1
Binary files /dev/null and b/docs/sources/docker-hub/hub-images/gh_service_hook.png differ
diff --git a/docs/sources/docker-hub/hub-images/gh_settings.png b/docs/sources/docker-hub/hub-images/gh_settings.png
new file mode 100644
index 0000000000..efb1a3abf5
Binary files /dev/null and b/docs/sources/docker-hub/hub-images/gh_settings.png differ