diff --git a/docs/sources/docker-hub/builds.md b/docs/sources/docker-hub/builds.md
index e4d64eb28e..1323f6ff9a 100644
--- a/docs/sources/docker-hub/builds.md
+++ b/docs/sources/docker-hub/builds.md
@@ -28,7 +28,8 @@ Automated Builds are supported for both public and private repositories on both
To use Automated Builds, you must have an
[account on Docker Hub](http://docs.docker.com/userguide/dockerhub/#creating-a-docker-hub-account)
-and on GitHub and/or Bitbucket.
+and on GitHub and/or Bitbucket. The account needs to be properly validated and activated
+before you can link to it.
## Setting up Automated Builds with GitHub
@@ -48,7 +49,8 @@ at the upper right of the screen. Then select
Select the [GitHub service](https://registry.hub.docker.com/associate/github/).
-Then follow the onscreen instructions to authorize and link your GitHub account to Docker Hub.
+Then follow the onscreen instructions to authorize and link your GitHub account to Docker Hub. Once it is linked, you'll be able to choose a repo from which to create the
+Automatic Build.
### Creating an Automated Build
@@ -85,7 +87,8 @@ Automated Build:
2. |
 |
Click on "Webhooks & Services" on the left side of the page. |
- 3. |  | Find the service labeled "Docker" and click on it. |
+ 3. |
+  | Find the service labeled "Docker" and click on it. |
4. |  |
Make sure the "Active" checkbox is selected and click the "Update service" button to save your changes. |
@@ -102,10 +105,11 @@ To get started, log into your Docker Hub account and click the "+ Add Repository
the upper right of the screen. Then select [Automated Build](https://registry.hub.docker.com/builds/add/).
Select the [Bitbucket
-service](https://registry.hub.docker.com/associate/bitbucket/).
+source](https://registry.hub.docker.com/associate/bitbucket/).
Then follow the onscreen instructions to authorize and link your Bitbucket account
-to Docker Hub.
+to Docker Hub. Once it is linked, you'll be able to choose a repo from which to create
+the Automatic Build.
### Creating an Automated Build
@@ -113,6 +117,42 @@ You can [create an Automated Build](
https://registry.hub.docker.com/builds/bitbucket/select/) from any of your
public or private Bitbucket repositories with a `Dockerfile`.
+### Adding a Hook
+
+When you link your Docker Hub account, a `POST` hook should get automatically added to
+your Bitbucket repo.
+Follow the steps below to confirm or modify the Bitbucket hooks for your
+Automated Build:
+
+
+
+
+ Step |
+ Screenshot |
+ Description |
+
+
+
+
+ 1. |
+  |
+ Log in to Bitbucket.org and go to your Repository page. Click on "Settings" on
+ the far left side of the page, under "Navigation". You must have admin privileges
+ to the repository in order to do this. |
+
+
+ 2. |
+  |
+ Click on "Hooks" on the near left side of the page, under "Settings". |
+
+ 3. |
+  | You should now see a list of hooks associated with the repo, including a POST hook that points at
+ registry.hub.docker.com/hooks/bitbucket. |
+
+
+
+
+
## The Dockerfile and Automated Builds
During the build process, Docker will copy the contents of your `Dockerfile`. It will
diff --git a/docs/sources/docker-hub/hub-images/bb_hooks.png b/docs/sources/docker-hub/hub-images/bb_hooks.png
new file mode 100644
index 0000000000..d51cd03ac4
Binary files /dev/null and b/docs/sources/docker-hub/hub-images/bb_hooks.png differ
diff --git a/docs/sources/docker-hub/hub-images/bb_menu.png b/docs/sources/docker-hub/hub-images/bb_menu.png
new file mode 100644
index 0000000000..6f4a6813ef
Binary files /dev/null and b/docs/sources/docker-hub/hub-images/bb_menu.png differ
diff --git a/docs/sources/docker-hub/hub-images/bb_post-hook.png b/docs/sources/docker-hub/hub-images/bb_post-hook.png
new file mode 100644
index 0000000000..78c4730665
Binary files /dev/null and b/docs/sources/docker-hub/hub-images/bb_post-hook.png differ