summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/ci/multi_project_pipelines.md19
1 files changed, 10 insertions, 9 deletions
diff --git a/doc/ci/multi_project_pipelines.md b/doc/ci/multi_project_pipelines.md
index 020a0947dae..e9deabf27f8 100644
--- a/doc/ci/multi_project_pipelines.md
+++ b/doc/ci/multi_project_pipelines.md
@@ -134,32 +134,33 @@ staging:
The `ENVIRONMENT` variable will be passed to every job defined in a downstream
pipeline. It will be available as an environment variable when GitLab Runner picks a job.
-In the following scenario `MY_VARIABLE` is also going to be passed downstream,
-because job-level `variables` inherit values from top-level `variables`:
+In the following configuration, the `MY_VARIABLE` variable will be passed
+downstream, because jobs inherit variables declared in top-level `variables`:
```yaml
variables:
MY_VARIABLE: my-value
-downstream:
+my-pipeline:
variables:
ENVIRONMENT: something
trigger: my/project
```
-You might want to pass some information about the upstream pipeline, using,
-for example, predefined variables. In order to do that you can use
-interpolation to pass any variable:
+You might want to pass some information about the upstream pipeline using, for
+example, predefined variables. In order to do that, you can use interpolation
+to pass any variable. For example:
```yaml
-downstream:
+my-pipeline:
variables:
UPSTREAM_BRANCH: $CI_COMMIT_REF_NAME
trigger: my/project
```
-`UPSTREAM_BRANCH` will be passed to a downstream pipeline and will be
-available within the context of all downstream builds.
+In this scenario, the `UPSTREAM_BRANCH` variable with a value related to the
+upstream pipeline will be passed to a `downstream` job, and will be available
+within the context of all downstream builds.
### Limitations