Merge pull request #2717 from thaJeztah/19.03_backport_update_git_remote_description

[19.03 backport] docs/build: add note about git subdirectories with BuildKit
Upstream-commit: 1fbcf9c7b62f37c7aa8edbe361a794bb285500f1
Component: cli

Author: silvin-lubecki

components/cli/docs/reference/commandline/build.md

@@ -110,6 +110,11 @@ Build Syntax Suffix             | Commit Used           | Build Context Used
 `myrepo.git#mytag:myfolder`     | `refs/tags/mytag`     | `/myfolder`
 `myrepo.git#mybranch:myfolder`  | `refs/heads/mybranch` | `/myfolder`
 
+> **Note**
+>
+> You cannot specify the build-context directory (`myfolder` in the examples above)
+> when using BuildKit as builder (`DOCKER_BUILDKIT=1`). Support for this feature
+> is tracked in [buildkit#1684](https://github.com/moby/buildkit/issues/1684).
 
 ### Tarball contexts