Add a note that the API of `https://gitlab.com` cannot always be used

[ci skip]

doc/api/README.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 Automate GitLab via a simple and powerful API. All definitions can be found
 under [`/lib/api`](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/lib/api).

doc/api/access_requests.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 >Introduced in GitLab 8.11.
 

doc/api/award_emoji.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 >[Introduced][ce-4575] in GitLab 8.9, snippet support in 8.12.
 

doc/api/boards.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 Every API call to boards must be authenticated.
 

doc/api/branches.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 ## List repository branches
 

doc/api/broadcast_messages.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 >Introduced in GitLab 8.12.
 

doc/api/build_triggers.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 You can read more about [triggering builds through the API](../ci/triggers/README.md).
 

doc/api/build_variables.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 ## List project variables
 

doc/api/builds.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 ## List project builds
 

doc/api/ci/README.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 ## Purpose
 

doc/api/ci/builds.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 API used by runners to receive and update builds.
 

doc/api/ci/lint.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 > [Introduced][ce-5953] in GitLab 8.12.
 

doc/api/ci/runners.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 API used by Runners to register and delete themselves.
 

doc/api/commits.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 ## List repository commits
 

doc/api/deploy_key_multiple_projects.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 If you want to easily add the same deploy key to multiple projects in the same
 group, this can be achieved quite easily with the API.

doc/api/deploy_keys.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 ## List all deploy keys
 

doc/api/deployments.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 ## List project deployments
 

doc/api/enviroments.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 ## List environments
 

doc/api/groups.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 ## List groups
 

doc/api/issues.md

@@ -3,7 +3,7 @@
 >**Note:**
 The `https://gitlab.example.com` URL that is presented in the examples of the
 API docs is fictional. Replace it with the URL of your GitLab instance,
-or in case of GitLab.com, use `https://gitlab.com`.
+or in case of GitLab.com, use `https://gitlab.com` (where applicable).
 
 Every API call to issues must be authenticated.