diff --git a/docker-cloud/builds/advanced.md b/docker-cloud/builds/advanced.md
index 0e57fe5d7b..44162660fb 100644
--- a/docker-cloud/builds/advanced.md
+++ b/docker-cloud/builds/advanced.md
@@ -34,6 +34,7 @@ sut:
     - SOURCE_BRANCH
 ```
 
+
 ## Override build, test or push commands
 
 Docker Cloud allows you to override and customize the `build`, `test` and `push`
@@ -111,3 +112,23 @@ If you needed to give the resulting image multiple tags, or push the same image
 docker tag $IMAGE_NAME $DOCKER_REPO:$SOURCE_COMMIT
 docker push $DOCKER_REPO:$SOURCE_COMMIT
 ```
+
+## Source Repository / Branch Clones
+
+When Docker Cloud pulls a branch from a source code repository, it performs
+a shallow clone (only the tip of the specified branch).  This has the advantage
+of minimizing the amount of data transfer necessary from the repository and 
+speeding up the build because it pulls only the minimal code necessary. 
+
+Because of this, if you need to perform a custom action that relies on a different 
+branch (such as a `post_push` hook), you won't be able checkout that branch, unless
+you do one of the following:
+
+* You can get a shallow checkout of the target branch by doing the following:
+
+		git fetch origin branch:mytargetbranch --depth 1
+
+* You can also "unshallow" the clone, which fetches the whole Git history (and potentially
+takes a long time / moves a lot of data) by using the `--unshallow` flag on the fetch:
+
+		git fetch --unshallow origin
diff --git a/docker-cloud/builds/automated-build.md b/docker-cloud/builds/automated-build.md
index 26a0a00d31..7f500c2cdd 100644
--- a/docker-cloud/builds/automated-build.md
+++ b/docker-cloud/builds/automated-build.md
@@ -126,7 +126,9 @@ By default when you set up autobuilds, a basic build rule is created for you. Th
 
     * Specify the **Dockerfile location** as a path relative to the root of the source code repository. (If the Dockerfile is at the repository root, leave this path set to `/`.)
 
-
+> **Note:** When Docker Cloud pulls a branch from a source code repository, it performs
+a shallow clone (only the tip of the specified branch).  Refer to [Advanced options for Autobuild and Autotest](advanced.md)
+for more information.
 
 ### Environment variables for builds