diff --git a/docs/reference/commandline/attach.md b/docs/reference/commandline/attach.md
index 34ae390544..4153331bad 100644
--- a/docs/reference/commandline/attach.md
+++ b/docs/reference/commandline/attach.md
@@ -34,6 +34,11 @@ Use `docker attach` to attach your terminal's standard input, output, and error
 ID or name. This allows you to view its ongoing output or to control it
 interactively, as though the commands were running directly in your terminal.
 
+> **Note:**
+> The `attach` command will display the output of the `ENTRYPOINT/CMD` process.  This
+> can appear as if the attach command is hung when in fact the process may simply
+> not be interacting with the terminal at that time.
+
 You can attach to the same contained process multiple times simultaneously,
 even as a different user with the appropriate permissions.
 
diff --git a/docs/reference/commandline/build.md b/docs/reference/commandline/build.md
index 5d34beca76..697c63647d 100644
--- a/docs/reference/commandline/build.md
+++ b/docs/reference/commandline/build.md
@@ -80,6 +80,10 @@ the command succeeds, the directory is sent to the Docker daemon as the
 context. Local clones give you the ability to access private repositories using
 local user credentials, VPN's, and so forth.
 
+> **Note:**
+> If the `URL` parameter contains a fragment the system will recursively clone
+> the repository and its submodules using a `git clone --recursive` command.
+
 Git URLs accept context configuration in their fragment section, separated by a
 colon `:`.  The first part represents the reference that Git will check out,
 this can be either a branch, a tag, or a commit SHA. The second part represents