From 5097cf4f78c2359c7eccd9b6e2d0adab12a3ace5 Mon Sep 17 00:00:00 2001
From: Steve Azzopardi <sazzopardi@gitlab.com>
Date: Tue, 18 Jun 2019 03:45:21 +0000
Subject: [PATCH] Add note about nested variables for GIT_CLONE_PATH

The variable $GIT_CLONE_PATH does not support nested variables, it will
only expand the variables once, not more.

reference https://gitlab.com/gitlab-org/gitlab-runner/issues/4319
---
 doc/ci/yaml/README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/doc/ci/yaml/README.md b/doc/ci/yaml/README.md
index 4c170056a49..2759f1c5160 100644
--- a/doc/ci/yaml/README.md
+++ b/doc/ci/yaml/README.md
@@ -2620,6 +2620,24 @@ test:
     - pwd
 ```
 
+### Nested paths
+
+The value of `GIT_CLONE_PATH` is expanded once and nesting variables
+within it is not supported.
+
+For example, you define both the variables below in your
+`.gitlab-ci.yml` file:
+
+```yml
+variables:
+  GOPATH: $CI_BUILDS_DIR/go
+  GIT_CLONE_PATH: $GOPATH/src/namespace/project
+```
+
+The value of `GIT_CLONE_PATH` is expanded once into
+`$CI_BUILDS_DIR/go/src/namespace/project`, and results in failure
+because `$CI_BUILDS_DIR` is not expanded.   
+
 ## Special YAML features
 
 It's possible to use special YAML features like anchors (`&`), aliases (`*`)