Clean up vale substitution warnings (api)

doc/api/deploy_tokens.md

@@ -10,7 +10,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/21811) in GitLab 12.9.
 
-Get a list of all deploy tokens across the GitLab instance. This endpoint requires administrator access.
+Get a list of all deploy tokens across the GitLab instance. This endpoint requires the Administrator role.
 
 ```plaintext
 GET /deploy_tokens

doc/api/instance_clusters.md

@@ -11,7 +11,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w
 Instance-level Kubernetes clusters allow you to connect a Kubernetes cluster to the GitLab instance, which enables you to use the same cluster across multiple projects. [More information](../user/instance/clusters/index.md)
 
 NOTE:
-Users need administrator access to use these endpoints.
+Users need the Administrator role to use these endpoints.
 
 ## List instance clusters
 

doc/api/packages/debian.md

@@ -78,7 +78,7 @@ GET projects/:id/packages/debian/pool/:distribution/:letter/:package_name/:packa
 | `letter`          | string | yes      | The Debian Classification (first-letter or lib-first-letter). |
 | `package_name`    | string | yes      | The source package name. |
 | `package_version` | string | yes      | The source package version. |
-| `file_name`       | string | yes      | The file name. |
+| `file_name`       | string | yes      | The filename. |
 
 ```shell
 curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/pool/my-distro/a/my-pkg/1.0.0/example_1.0.0~alpha2_amd64.deb"
@@ -92,7 +92,7 @@ curl --header "Private-Token: <personal_access_token>" \
      --remote-name
 ```
 
-This writes the downloaded file using the remote file name in the current directory.
+This writes the downloaded file using the remote filename in the current directory.
 
 ## Route prefix
 
@@ -150,7 +150,7 @@ curl --header "Private-Token: <personal_access_token>" \
      --remote-name
 ```
 
-This writes the downloaded file using the remote file name in the current directory.
+This writes the downloaded file using the remote filename in the current directory.
 
 ## Download a signed distribution Release file
 
@@ -178,7 +178,7 @@ curl --header "Private-Token: <personal_access_token>" \
      --remote-name
 ```
 
-This writes the downloaded file using the remote file name in the current directory.
+This writes the downloaded file using the remote filename in the current directory.
 
 ## Download a release file signature
 
@@ -206,7 +206,7 @@ curl --header "Private-Token: <personal_access_token>" \
      --remote-name
 ```
 
-This writes the downloaded file using the remote file name in the current directory.
+This writes the downloaded file using the remote filename in the current directory.
 
 ## Download a binary file's index
 
@@ -236,4 +236,4 @@ curl --header "Private-Token: <personal_access_token>" \
      --remote-name
 ```
 
-This writes the downloaded file using the remote file name in the current directory.
+This writes the downloaded file using the remote filename in the current directory.

doc/api/packages/helm.md

@@ -63,7 +63,7 @@ GET projects/:id/packages/helm/:channel/charts/:file_name.tgz
 | ----------- | ------ | -------- | ----------- |
 | `id`        | string | yes      | The ID or full path of the project. |
 | `channel`   | string | yes      | Helm repository channel. |
-| `file_name` | string | yes      | Chart file name. |
+| `file_name` | string | yes      | Chart filename. |
 
 ```shell
 curl --user <username>:<personal_access_token> \

doc/api/pipeline_schedules.md

@@ -115,7 +115,7 @@ POST /projects/:id/pipeline_schedules
 | `description`   | string         | yes      | The description of the pipeline schedule.                                                                               |
 | `ref`           | string         | yes      | The branch or tag name that is triggered.                                                                               |
 | `cron`          | string         | yes      | The [cron](https://en.wikipedia.org/wiki/Cron) schedule, for example: `0 1 * * *`.                                      |
-| `cron_timezone` | string         | no       | The timezone supported by `ActiveSupport::TimeZone`, for example: `Pacific Time (US & Canada)` (default: `UTC`).        |
+| `cron_timezone` | string         | no       | The time zone supported by `ActiveSupport::TimeZone`, for example: `Pacific Time (US & Canada)` (default: `UTC`).        |
 | `active`        | boolean        | no       | The activation of pipeline schedule. If false is set, the pipeline schedule is initially deactivated (default: `true`). |
 
 ```shell
@@ -162,7 +162,7 @@ PUT /projects/:id/pipeline_schedules/:pipeline_schedule_id
 | `description`          | string         | no       | The description of the pipeline schedule.                                                                        |
 | `ref`                  | string         | no       | The branch or tag name that is triggered.                                                                        |
 | `cron`                 | string         | no       | The [cron](https://en.wikipedia.org/wiki/Cron) schedule, for example: `0 1 * * *`.                               |
-| `cron_timezone`        | string         | no       | The timezone supported by `ActiveSupport::TimeZone` (for example `Pacific Time (US & Canada)`), or `TZInfo::Timezone` (for example `America/Los_Angeles`). |
+| `cron_timezone`        | string         | no       | The time zone supported by `ActiveSupport::TimeZone` (for example `Pacific Time (US & Canada)`), or `TZInfo::Timezone` (for example `America/Los_Angeles`). |
 | `active`               | boolean        | no       | The activation of pipeline schedule. If false is set, the pipeline schedule is initially deactivated.            |
 
 ```shell