Merge branch 'ticket_126158_vlad' into 'master'

Portray better use of types of variables in .gitlab-ci.yml

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

doc/ci/variables/README.md

@@ -370,8 +370,11 @@ variables take precedence over those defined in `.gitlab-ci.yml`.
 ## Unsupported variables
 
 There are cases where some variables cannot be used in the context of a
-`.gitlab-ci.yml` definition (for example under `script`). Read more
-about which variables are [not supported](where_variables_can_be_used.md).
+`.gitlab-ci.yml` definition (for example under `script`). Read more about which variables are [not supported](where_variables_can_be_used.md).
+ 
+## Where variables can be used 
+
+Click [here](where_variables_can_be_used.md) for a section that describes where and how the different types of variables can be used.
 
 ## Advanced use