Standardize contribution note

Make sure all notes are at the same place in every
template, at the very top. This keeps the template
detail notes closer to the template contents.

lib/gitlab/ci/templates/5-Minute-Production-App.gitlab-ci.yml

-# This template is on early stage of development.
-# Use it with caution. For usage instruction please read
-# https://gitlab.com/gitlab-org/5-minute-production-app/deploy-template/-/blob/v2.3.0/README.md
-
 # Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/5-Minute-Production-App.gitlab-ci.yml
 
+# This template is on early stage of development.
+# Use it with caution. For usage instruction please read
+# https://gitlab.com/gitlab-org/5-minute-production-app/deploy-template/-/blob/v2.3.0/README.md
+
 include:
   # workflow rules to prevent duplicate detached pipelines
   - template: 'Workflows/Branch-Pipelines.gitlab-ci.yml'

lib/gitlab/ci/templates/Android-Fastlane.gitlab-ci.yml

-# Read more about how to use this script on this blog post https://about.gitlab.com/2019/01/28/android-publishing-with-gitlab-and-fastlane/
-# You will also need to configure your build.gradle, Dockerfile, and fastlane configuration to make this work.
-# If you are looking for a simpler template that does not publish, see the Android template.
-
 # Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Android-Fastlane.gitlab-ci.yml
 
+# Read more about how to use this script on this blog post https://about.gitlab.com/2019/01/28/android-publishing-with-gitlab-and-fastlane/
+# You will also need to configure your build.gradle, Dockerfile, and fastlane configuration to make this work.
+# If you are looking for a simpler template that does not publish, see the Android template.
+
 stages:
   - environment
   - build

lib/gitlab/ci/templates/Android.gitlab-ci.yml

-# Read more about this script on this blog post https://about.gitlab.com/2018/10/24/setting-up-gitlab-ci-for-android-projects/, by Jason Lenny
-# If you are interested in using Android with FastLane for publishing take a look at the Android-Fastlane template.
-
 # Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Android.gitlab-ci.yml
 
+# Read more about this script on this blog post https://about.gitlab.com/2018/10/24/setting-up-gitlab-ci-for-android-projects/, by Jason Lenny
+# If you are interested in using Android with FastLane for publishing take a look at the Android-Fastlane template.
+
 image: openjdk:8-jdk
 
 variables:

lib/gitlab/ci/templates/Auto-DevOps.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Auto-DevOps.gitlab-ci.yml
+
 # Auto DevOps
+#
 # This CI/CD configuration provides a standard pipeline for
 # * building a Docker image (using a buildpack if necessary),
 # * storing the image in the container registry,
@@ -41,11 +47,6 @@
 # `.buildpacks` that contains the URLs, one on each line, in order.
 # Note: Auto CI does not work with multiple buildpacks yet
 
-# Please contribute improvements to this template via the CI/CD templates development guide:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific templates file can be found here:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Auto-DevOps.gitlab-ci.yml
-
 image: alpine:latest
 
 variables:

lib/gitlab/ci/templates/Bash.gitlab-ci.yml

-# see https://docs.gitlab.com/ee/ci/yaml/README.html for all available options
-
 # Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Bash.gitlab-ci.yml
 
+# See https://docs.gitlab.com/ee/ci/yaml/README.html for all available options
+
 # you can delete this line if you're not using Docker
 image: busybox:latest
 

lib/gitlab/ci/templates/C++.gitlab-ci.yml

-# use the official gcc image, based on debian
-# can use verions as well, like gcc:5.2
-# see https://hub.docker.com/_/gcc/
-
 # Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/C++.gitlab-ci.yml
 
+# use the official gcc image, based on debian
+# can use verions as well, like gcc:5.2
+# see https://hub.docker.com/_/gcc/
+
 image: gcc
 
 build:

lib/gitlab/ci/templates/Chef.gitlab-ci.yml

-# This file uses Test Kitchen with the kitchen-dokken driver to
+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Chef.gitlab-ci.yml
+
+# This template uses Test Kitchen with the kitchen-dokken driver to
 # perform functional testing. Doing so requires that your runner be a
 # Docker runner configured for privileged mode. Please see
 # https://docs.gitlab.com/runner/executors/docker.html#use-docker-in-docker-with-privileged-mode
 # for help configuring your runner properly, or, if you want to switch
 # to a different driver, see http://kitchen.ci/docs/drivers
 
-# Please contribute improvements to this template via the CI/CD templates development guide:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific templates file can be found here:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Chef.gitlab-ci.yml
-
 image: "chef/chefdk"
 services:
   - docker:dind

lib/gitlab/ci/templates/Code-Quality.gitlab-ci.yml

-# Please contribute improvements to this template via the CI/CD templates development guide:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific templates file can be found here:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Code-Quality.gitlab-ci.yml
-
 include:
   template: Jobs/Code-Quality.gitlab-ci.yml

lib/gitlab/ci/templates/Docker.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Docker.gitlab-ci.yml
+
 # Build a Docker image with CI/CD and push to the GitLab registry.
 # Docker-in-Docker documentation: https://docs.gitlab.com/ee/ci/docker/using_docker_build.html
 #
 # This template uses one generic job with conditional builds
 # for the default branch and all other (MR) branches.
 
-# Please contribute improvements to this template via the CI/CD templates development guide:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific templates file can be found here:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Docker.gitlab-ci.yml
-
 docker-build:
   # Use the official docker image.
   image: docker:latest

lib/gitlab/ci/templates/Getting-Started.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Getting-Started.gitlab-ci.yml
+
 # This is a sample GitLab CI/CD configuration file that should run without any modifications.
 # It demonstrates a basic 3 stage CI/CD pipeline. Instead of real tests or scripts,
 # it uses echo commands to simulate the pipeline execution.

lib/gitlab/ci/templates/Gradle.gitlab-ci.yml

-# This is the Gradle build system for JVM applications
-# https://gradle.org/
-# https://github.com/gradle/gradle
-
 # Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Gradle.gitlab-ci.yml
+
+# This is the Gradle build system for JVM applications
+# https://gradle.org/
+# https://github.com/gradle/gradle
+
 image: gradle:alpine
 
 # Disable the Gradle daemon for Continuous Integration servers as correctness

lib/gitlab/ci/templates/Grails.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Grails.gitlab-ci.yml
+
 # This template uses the java:8 docker image because there isn't any
 # official Grails image at this moment
 #
@@ -8,11 +13,6 @@
 # Feel free to change GRADLE_VERSION version with your gradle project version (2.13, 2.14,...)
 # If you use Angular profile, this yml it's prepared to work with it
 
-# Please contribute improvements to this template via the CI/CD templates development guide:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific templates file can be found here:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Grails.gitlab-ci.yml
-
 image: java:8
 
 variables:

lib/gitlab/ci/templates/Hello-World.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Grails.gitlab-ci.yml
+#
 # This file is a template demonstrating the `script` keyword.
 # Learn more about this keyword here: https://docs.gitlab.com/ee/ci/yaml/README.html#script
 

lib/gitlab/ci/templates/Julia.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Julia.gitlab-ci.yml
+
 # This is an example .gitlab-ci.yml file to test (and optionally report the coverage
 # results of) your [Julia][1] packages. Please refer to the [documentation][2]
 # for more information about package development in Julia.
@@ -8,11 +13,6 @@
 # [1]: http://julialang.org/
 # [2]: https://docs.julialang.org/en/v1/manual/documentation/index.html
 
-# Please contribute improvements to this template via the CI/CD templates development guide:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific templates file can be found here:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Julia.gitlab-ci.yml
-
 # Below is the template to run your tests in Julia
 .test_template: &test_definition
   # Uncomment below (and adjust as needed) to run the tests for specific references

lib/gitlab/ci/templates/Maven.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Maven.gitlab-ci.yml
+
 # Build JAVA applications using Apache Maven (http://maven.apache.org)
 # For docker image tags see https://hub.docker.com/_/maven/
 #
@@ -8,11 +13,6 @@
 # * Verify but don't deploy merge requests.
 # * Deploy built artifacts from master branch only.
 
-# Please contribute improvements to this template via the CI/CD templates development guide:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific templates file can be found here:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Maven.gitlab-ci.yml
-
 variables:
   # This will suppress any download for dependencies and plugins or upload messages which would clutter the console log.
   # `showDateTime` will show the passed time in milliseconds. You need to specify `--batch-mode` to make this work.

lib/gitlab/ci/templates/Mono.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Mono.gitlab-ci.yml
+
 # This is a simple gitlab continuous integration template (compatible with the shared runner provided on gitlab.com)
 # using the official mono docker image to build a visual studio project.
 #
@@ -11,11 +16,6 @@
 # Please find the full example project here:
 # https://gitlab.com/tobiaskoch/gitlab-ci-example-mono
 
-# Please contribute improvements to this template via the CI/CD templates development guide:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific templates file can be found here:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Mono.gitlab-ci.yml
-
 # see https://hub.docker.com/_/mono/
 image: mono:latest
 

lib/gitlab/ci/templates/Security/API-Fuzzing.gitlab-ci.yml

@@ -2,7 +2,7 @@
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Security/API-Fuzzing.gitlab-ci.yml
-#
+
 # Read more about this feature here: https://docs.gitlab.com/ee/user/application_security/api_fuzzing/
 #
 # Configure API fuzzing with CI/CD variables (https://docs.gitlab.com/ee/ci/variables/README.html).

lib/gitlab/ci/templates/Security/API-Fuzzing.latest.gitlab-ci.yml

-# Read more about this feature here: https://docs.gitlab.com/ee/user/application_security/api_fuzzing/
+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Security/API-Fuzzing.lastest.gitlab-ci.yml
 
+# Read more about this feature here: https://docs.gitlab.com/ee/user/application_security/api_fuzzing/
+#
 # Configure API fuzzing with CI/CD variables (https://docs.gitlab.com/ee/ci/variables/README.html).
 # List of available variables: https://docs.gitlab.com/ee/user/application_security/api_fuzzing/#available-cicd-variables
 

lib/gitlab/ci/templates/Security/Container-Scanning.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Security/Container-Scanning.gitlab-ci.yml
+
 # Use this template to enable container scanning in your project.
 # You should add this template to an existing `.gitlab-ci.yml` file by using the `include:`
 # keyword.
@@ -16,11 +21,6 @@
 # Configure container scanning with CI/CD variables (https://docs.gitlab.com/ee/ci/variables/README.html).
 # List of available variables: https://docs.gitlab.com/ee/user/application_security/container_scanning/#available-variables
 
-# Please contribute improvements to this template via the CI/CD templates development guide:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific templates file can be found here:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Security/Container-Scanning.gitlab-ci.yml
-
 variables:
   CS_ANALYZER_IMAGE: registry.gitlab.com/security-products/container-scanning:4
 

lib/gitlab/ci/templates/Security/Coverage-Fuzzing.gitlab-ci.yml

@@ -2,7 +2,7 @@
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Security/Coverage-Fuzzing.gitlab-ci.yml
-#
+
 # Read more about this feature https://docs.gitlab.com/ee/user/application_security/coverage_fuzzing
 #
 # Configure coverage fuzzing with CI/CD variables (https://docs.gitlab.com/ee/ci/variables/README.html).

lib/gitlab/ci/templates/Security/DAST-API.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Security/Dast-API.gitlab-ci.yml
+
 # To use this template, add the following to your .gitlab-ci.yml file:
 #
 # include:

lib/gitlab/ci/templates/Security/DAST.gitlab-ci.yml

@@ -2,7 +2,7 @@
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Security/DAST.gitlab-ci.yml
-#
+
 # To use this template, add the following to your .gitlab-ci.yml file:
 #
 # include:

lib/gitlab/ci/templates/Security/DAST.latest.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Security/DAST.lastest.gitlab-ci.yml
+
 # To use this template, add the following to your .gitlab-ci.yml file:
 #
 # include:
@@ -16,11 +21,6 @@
 # Configure DAST with CI/CD variables (https://docs.gitlab.com/ee/ci/variables/README.html).
 # List of available variables: https://docs.gitlab.com/ee/user/application_security/dast/#available-variables
 
-# Please contribute improvements to this template via the CI/CD templates development guide:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific templates file can be found here:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Security/DAST.lastest.gitlab-ci.yml
-
 variables:
   DAST_VERSION: 2
   # Setting this variable will affect all Security templates

lib/gitlab/ci/templates/Security/Dependency-Scanning.gitlab-ci.yml

-# Read more about this feature here: https://docs.gitlab.com/ee/user/application_security/dependency_scanning/
-#
-# Configure dependency scanning with CI/CD variables (https://docs.gitlab.com/ee/ci/variables/README.html).
-# List of available variables: https://docs.gitlab.com/ee/user/application_security/dependency_scanning/index.html#available-variables
-
 # Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Security/Dependency-Scanning.gitlab-ci.yml
 
+# Read more about this feature here: https://docs.gitlab.com/ee/user/application_security/dependency_scanning/
+#
+# Configure dependency scanning with CI/CD variables (https://docs.gitlab.com/ee/ci/variables/README.html).
+# List of available variables: https://docs.gitlab.com/ee/user/application_security/dependency_scanning/index.html#available-variables
+
 variables:
   # Setting this variable will affect all Security templates
   # (SAST, Dependency Scanning, ...)

lib/gitlab/ci/templates/Security/License-Scanning.gitlab-ci.yml

-# Read more about this feature here: https://docs.gitlab.com/ee/user/compliance/license_compliance/index.html
-#
-# Configure license scanning with CI/CD variables (https://docs.gitlab.com/ee/ci/variables/README.html).
-# List of available variables: https://docs.gitlab.com/ee/user/compliance/license_compliance/#available-variables
-
 # Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Security/License-Scanning.gitlab-ci.yml
 
+# Read more about this feature here: https://docs.gitlab.com/ee/user/compliance/license_compliance/index.html
+#
+# Configure license scanning with CI/CD variables (https://docs.gitlab.com/ee/ci/variables/README.html).
+# List of available variables: https://docs.gitlab.com/ee/user/compliance/license_compliance/#available-variables
+
 variables:
   # Setting this variable will affect all Security templates
   # (SAST, Dependency Scanning, ...)

lib/gitlab/ci/templates/Security/Secure-Binaries.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Security/Secure-Binaries.gitlab-ci.yml
+
 # This template should be used when Security Products (https://about.gitlab.com/handbook/engineering/development/secure/#security-products)
 # have to be downloaded and stored locally.
 #
 # Usage:
 #
-# ```
-#   include:
-#     - template: Secure-Binaries.gitlab-ci.yml
-# ```
+# include:
+#   - template: Secure-Binaries.gitlab-ci.yml
 #
 # Docs: https://docs.gitlab.com/ee/topics/airgap/
 
-# Please contribute improvements to this template via the CI/CD templates development guide:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific templates file can be found here:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Security/Secure-Binaries.gitlab-ci.yml
-
 variables:
   SECURE_BINARIES_ANALYZERS: >-
     bandit, brakeman, gosec, spotbugs, flawfinder, phpcs-security-audit, security-code-scan, nodejs-scan, eslint, secrets, sobelow, pmd-apex, kubesec, semgrep,

lib/gitlab/ci/templates/Verify/Accessibility.gitlab-ci.yml

-# Read more about the feature here: https://docs.gitlab.com/ee/user/project/merge_requests/accessibility_testing.html
-
 # Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Verify/Accessibility.gitlab-ci.yml
 
+# Read more about the feature here: https://docs.gitlab.com/ee/user/project/merge_requests/accessibility_testing.html
+
 stages:
   - build
   - test

lib/gitlab/ci/templates/Verify/Browser-Performance.gitlab-ci.yml

-# Read more about the feature here: https://docs.gitlab.com/ee/user/project/merge_requests/browser_performance_testing.html
-
 # Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Verify/Browser-Performance.gitlab-ci.yml
 
+# Read more about the feature here: https://docs.gitlab.com/ee/user/project/merge_requests/browser_performance_testing.html
+
 stages:
   - build
   - test

lib/gitlab/ci/templates/Verify/Browser-Performance.latest.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Verify/Browser-Performance.latest.gitlab-ci.yml
+
 # Read more about the feature here: https://docs.gitlab.com/ee/user/project/merge_requests/browser_performance_testing.html
 
 stages:

lib/gitlab/ci/templates/Verify/Load-Performance-Testing.gitlab-ci.yml

-# Read more about the feature here: https://docs.gitlab.com/ee/user/project/merge_requests/load_performance_testing.html
-
 # Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Verify/Load-Performance-Testing.gitlab-ci.yml
 
+# Read more about the feature here: https://docs.gitlab.com/ee/user/project/merge_requests/load_performance_testing.html
+
 stages:
   - build
   - test

lib/gitlab/ci/templates/Workflows/Branch-Pipelines.gitlab-ci.yml

-# Read more on when to use this template at
-# https://docs.gitlab.com/ee/ci/yaml/#workflowrules
-
 # Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Workflows/Branch-Pipelines.gitlab-ci.yml
 
+# Read more on when to use this template at
+# https://docs.gitlab.com/ee/ci/yaml/#workflowrules
+
 workflow:
   rules:
     - if: $CI_COMMIT_TAG

lib/gitlab/ci/templates/Workflows/MergeRequest-Pipelines.gitlab-ci.yml

-# Read more on when to use this template at
-# https://docs.gitlab.com/ee/ci/yaml/#workflowrules
-
 # Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Workflows/MergeRequest-Pipelines.gitlab-ci.yml
 
+# Read more on when to use this template at
+# https://docs.gitlab.com/ee/ci/yaml/#workflowrules
+
 workflow:
   rules:
     - if: $CI_MERGE_REQUEST_IID

lib/gitlab/ci/templates/dotNET-Core.yml

----
-# This is a simple example illustrating how to build and test .NET Core project
-# with GitLab Continuous Integration / Continuous Delivery.
-
-# Please contribute improvements to this template via the CI/CD templates development guide:
+# Please contribute improvements to this template via the CI/CD templates development guide:
 # https://docs.gitlab.com/ee/development/cicd/templates.html
 # This specific templates file can be found here:
 # https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/dotNET-Core.yml
 
+# This is a simple example illustrating how to build and test .NET Core project
+# with GitLab Continuous Integration / Continuous Delivery.
+#
 # ### Specify the Docker image
 #
 # Instead of installing .NET Core SDK manually, a docker image is used

lib/gitlab/ci/templates/dotNET.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/dotNET.gitlab-ci.yml
+
 # The following script will work for any project that can be built from command line by msbuild
 # It uses powershell shell executor, so you need to add the following line to your config.toml file
 # (located in gitlab-runner.exe directory):
@@ -19,11 +24,6 @@
 # The best way to persist the mapping is via a scheduled task (see: https://stackoverflow.com/a/7867064/1288473),
 # running the following batch command: net use P: \\x.x.x.x\Projects /u:your_user your_pass /persistent:yes
 
-# Please contribute improvements to this template via the CI/CD templates development guide:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific templates file can be found here:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/dotNET.gitlab-ci.yml
-
 # place project specific paths in variables to make the rest of the script more generic
 variables:
   EXE_RELEASE_FOLDER: 'YourApp\bin\Release'

lib/gitlab/ci/templates/iOS-Fastlane.gitlab-ci.yml

+# Please contribute improvements to this template via the CI/CD templates development guide:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific templates file can be found here:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/iOS-Fastlane.gitlab-ci.yml
+
 # This is a very simple template that mainly relies on FastLane to build and distribute your app.
 # Read more about how to use this template on the blog post https://about.gitlab.com/2019/03/06/ios-publishing-with-gitlab-and-fastlane/
 # You will also need fastlane and signing configuration for this to work, along with a MacOS runner.
@@ -10,11 +15,6 @@
 # https://docs.gitlab.com/runner/security/#usage-of-shell-executor for additional
 # detail on what to keep in mind in this scenario.
 
-# Please contribute improvements to this template via the CI/CD templates development guide:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific templates file can be found here:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/iOS-Fastlane.gitlab-ci.yml
-
 stages:
   - build
   - test