Merge branch 'docs/edit-notes-about-remote-includes' into 'master'

Edit note about remote includes

Closes #58836

See merge request gitlab-org/gitlab-ce!25999

1 files changed, 5 insertions, 8 deletions

diff --git a/doc/ci/yaml/README.md b/doc/ci/yaml/README.md
index 5ed7ad42a8d..135de68e200 100644
--- a/doc/ci/yaml/README.md
+++ b/doc/ci/yaml/README.md
@@ -1703,6 +1703,11 @@ of using YAML anchors, you can use the [`extends` keyword](#extends).
 
 See [usage examples](#include-examples).
 
+NOTE: **Note:**
+`.gitlab-ci.yml` configuration included by all methods is evaluated at pipeline creation.
+The configuration is a snapshot in time and persisted in the database. Any changes to
+referenced `.gitlab-ci.yml` configuration will not be reflected in GitLab until the next pipeline is created.
+
 #### `include:local`
 
 `include:local` includes a file from the same repository as `.gitlab-ci.yml`.
@@ -1793,14 +1798,6 @@ include:
 All nested includes will be executed without context as public user, so only another remote,
 or public project, or template is allowed.
 
-NOTE: **Note:**
-Changes to remote includes will not have effect on already created pipelines,
-because the include is being evaluated at the time of pipeline creation.
-This is when full definition of CI yaml is being expanded in order to create
-pipeline with stages with jobs. You always retry job that is already created,
-thus created after pipeline creation. To re-include all (thus re-evaluate the
-configuration), you have to re-create pipeline.
-
 #### Nested includes
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/56836) in GitLab 11.9.