Commit bc59e60e authored by Evan Read's avatar Evan Read Committed by Marcel Amirault

Fix capitalization of ID in more places

parent 3614deb7
...@@ -94,7 +94,7 @@ The OpenID Connect will provide you with a client details and secret for you to ...@@ -94,7 +94,7 @@ The OpenID Connect will provide you with a client details and secret for you to
- `basic` - HTTP Basic Authentication - `basic` - HTTP Basic Authentication
- `jwt_bearer` - JWT based authentication (private key and client secret signing) - `jwt_bearer` - JWT based authentication (private key and client secret signing)
- `mtls` - Mutual TLS or X.509 certificate validation - `mtls` - Mutual TLS or X.509 certificate validation
- Any other value will POST the client id and secret in the request body - Any other value will POST the client ID and secret in the request body
- If not specified, defaults to `basic`. - If not specified, defaults to `basic`.
- `<uid_field>` (optional) is the field name from the `user_info` details that will be used as `uid` value. For example, `preferred_username`. - `<uid_field>` (optional) is the field name from the `user_info` details that will be used as `uid` value. For example, `preferred_username`.
If this value is not provided or the field with the configured value is missing from the `user_info` details, the `uid` will use the `sub` field. If this value is not provided or the field with the configured value is missing from the `user_info` details, the `uid` will use the `sub` field.
......
...@@ -169,10 +169,10 @@ diagram delimiters `@startuml`/`@enduml` as these are replaced by the AsciiDoc ` ...@@ -169,10 +169,10 @@ diagram delimiters `@startuml`/`@enduml` as these are replaced by the AsciiDoc `
Some parameters can be added to the AsciiDoc block definition: Some parameters can be added to the AsciiDoc block definition:
- *format*: Can be either `png` or `svg`. Note that `svg` is not supported by - `format`: Can be either `png` or `svg`. Note that `svg` is not supported by
all browsers so use with care. The default is `png`. all browsers so use with care. The default is `png`.
- *id*: A CSS id added to the diagram HTML tag. - `id`: A CSS ID added to the diagram HTML tag.
- *width*: Width attribute added to the image tag. - `width`: Width attribute added to the image tag.
- *height*: Height attribute added to the image tag. - `height`: Height attribute added to the image tag.
Markdown does not support any parameters and will always use PNG format. Markdown does not support any parameters and will always use PNG format.
...@@ -78,7 +78,7 @@ The following metrics are available: ...@@ -78,7 +78,7 @@ The following metrics are available:
| `gitlab_transaction_event_remove_tag_total` | Counter | 9.4 | Counter when a tag is remove for any repository | | | `gitlab_transaction_event_remove_tag_total` | Counter | 9.4 | Counter when a tag is remove for any repository | |
| `gitlab_transaction_event_sidekiq_exception_total` | Counter | 9.4 | Counter of Sidekiq exceptions | | | `gitlab_transaction_event_sidekiq_exception_total` | Counter | 9.4 | Counter of Sidekiq exceptions | |
| `gitlab_transaction_event_stuck_import_jobs_total` | Counter | 9.4 | Count of stuck import jobs | `projects_without_jid_count`, `projects_with_jid_count` | | `gitlab_transaction_event_stuck_import_jobs_total` | Counter | 9.4 | Count of stuck import jobs | `projects_without_jid_count`, `projects_with_jid_count` |
| `gitlab_transaction_event_update_build_total` | Counter | 9.4 | Counter for update build for API /jobs/request/:id | | | `gitlab_transaction_event_update_build_total` | Counter | 9.4 | Counter for update build for API `/jobs/request/:id` | |
| `gitlab_transaction_new_redis_connections_total` | Counter | 9.4 | Counter for new Redis connections | | | `gitlab_transaction_new_redis_connections_total` | Counter | 9.4 | Counter for new Redis connections | |
| `gitlab_transaction_queue_duration_total` | Counter | 9.4 | Duration jobs were enqueued before processing | | | `gitlab_transaction_queue_duration_total` | Counter | 9.4 | Duration jobs were enqueued before processing | |
| `gitlab_transaction_rails_queue_duration_total` | Counter | 9.4 | Measures latency between GitLab Workhorse forwarding a request to Rails | `controller`, `action` | | `gitlab_transaction_rails_queue_duration_total` | Counter | 9.4 | Measures latency between GitLab Workhorse forwarding a request to Rails | `controller`, `action` |
......
...@@ -50,7 +50,7 @@ the GitLab server itself, but your setup may vary. If the CA is only ...@@ -50,7 +50,7 @@ the GitLab server itself, but your setup may vary. If the CA is only
used for GitLab consider putting this in the `Match User git` section used for GitLab consider putting this in the `Match User git` section
(described below). (described below).
The SSH certificates being issued by that CA **MUST** have a "key id" The SSH certificates being issued by that CA **MUST** have a "key ID"
corresponding to that user's username on GitLab, e.g. (some output corresponding to that user's username on GitLab, e.g. (some output
omitted for brevity): omitted for brevity):
...@@ -77,7 +77,7 @@ own `AuthorizedPrincipalsCommand` to do that mapping instead of using ...@@ -77,7 +77,7 @@ own `AuthorizedPrincipalsCommand` to do that mapping instead of using
our provided default. our provided default.
The important part is that the `AuthorizedPrincipalsCommand` must be The important part is that the `AuthorizedPrincipalsCommand` must be
able to map from the "key id" to a GitLab username in some way, the able to map from the "key ID" to a GitLab username in some way, the
default command we ship assumes there's a 1=1 mapping between the two, default command we ship assumes there's a 1=1 mapping between the two,
since the whole point of this is to allow us to extract a GitLab since the whole point of this is to allow us to extract a GitLab
username from the key itself, instead of relying on something like the username from the key itself, instead of relying on something like the
...@@ -122,7 +122,7 @@ into multiple lines of `authorized_keys` output, as described in the ...@@ -122,7 +122,7 @@ into multiple lines of `authorized_keys` output, as described in the
Normally when using the `AuthorizedKeysCommand` with OpenSSH the Normally when using the `AuthorizedKeysCommand` with OpenSSH the
principal is some "group" that's allowed to log into that principal is some "group" that's allowed to log into that
server. However with GitLab it's only used to appease OpenSSH's server. However with GitLab it's only used to appease OpenSSH's
requirement for it, we effectively only care about the "key id" being requirement for it, we effectively only care about the "key ID" being
correct. Once that's extracted GitLab will enforce its own ACLs for correct. Once that's extracted GitLab will enforce its own ACLs for
that user (e.g. what projects the user can access). that user (e.g. what projects the user can access).
......
...@@ -124,7 +124,7 @@ GitLab server. For example, on a default Omnibus installation this would be ...@@ -124,7 +124,7 @@ GitLab server. For example, on a default Omnibus installation this would be
`/var/opt/gitlab/git-data/repositories/@hashed/b1/7e/b17ef6d19c7a5b1ee83b907c595526dcb1eb06db8227d650d5dda0a9f4ce8cd9.git` `/var/opt/gitlab/git-data/repositories/@hashed/b1/7e/b17ef6d19c7a5b1ee83b907c595526dcb1eb06db8227d650d5dda0a9f4ce8cd9.git`
with `.git` from the end of the directory name removed. with `.git` from the end of the directory name removed.
The output includes the project id and the project name: The output includes the project ID and the project name:
```plaintext ```plaintext
=> #<Project id:16 it/supportteam/ticketsystem> => #<Project id:16 it/supportteam/ticketsystem>
......
...@@ -282,7 +282,8 @@ Commonly, `<condition>` references the job arguments, which depend on the type o ...@@ -282,7 +282,8 @@ Commonly, `<condition>` references the job arguments, which depend on the type o
For example, `repository_import` has `project_id` as the job argument, while `update_merge_requests` has `project_id, user_id, oldrev, newrev, ref`. For example, `repository_import` has `project_id` as the job argument, while `update_merge_requests` has `project_id, user_id, oldrev, newrev, ref`.
NOTE: **Note:** Arguments need to be referenced by their sequence id using `job.args[<id>]` because `job.args` is a list of all arguments provided to the Sidekiq job. NOTE: **Note:**
Arguments need to be referenced by their sequence ID using `job.args[<id>]` because `job.args` is a list of all arguments provided to the Sidekiq job.
Here are some examples: Here are some examples:
......
...@@ -446,9 +446,9 @@ For example: ...@@ -446,9 +446,9 @@ For example:
DELETE /projects/:id/share/:group_id DELETE /projects/:id/share/:group_id
``` ```
The `:id` path parameter needs to be replaced with the project id, and the `:group_id` needs to be replaced with the id of the group. The colons `:` should not be included. The `:id` path parameter needs to be replaced with the project ID, and the `:group_id` needs to be replaced with the ID of the group. The colons `:` should not be included.
The resulting cURL call for a project with id `5` and a group id of `17` is then: The resulting cURL call for a project with ID `5` and a group ID of `17` is then:
```shell ```shell
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/projects/5/share/17 curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/projects/5/share/17
......
...@@ -93,7 +93,7 @@ Parameters: ...@@ -93,7 +93,7 @@ Parameters:
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
|:----------|:--------|:---------|:----------------------------------------------------| |:----------|:--------|:---------|:----------------------------------------------------|
| `id` | integer | yes | The id of the application (not the application_id). | | `id` | integer | yes | The ID of the application (not the application_id). |
Example request: Example request:
......
...@@ -94,7 +94,7 @@ POST /projects/:id/repository/commits ...@@ -94,7 +94,7 @@ POST /projects/:id/repository/commits
| `previous_path` | string | no | Original full path to the file being moved. Ex. `lib/class1.rb`. Only considered for `move` action. | | `previous_path` | string | no | Original full path to the file being moved. Ex. `lib/class1.rb`. Only considered for `move` action. |
| `content` | string | no | File content, required for all except `delete`, `chmod`, and `move`. Move actions that do not specify `content` will preserve the existing file content, and any other value of `content` will overwrite the file content. | | `content` | string | no | File content, required for all except `delete`, `chmod`, and `move`. Move actions that do not specify `content` will preserve the existing file content, and any other value of `content` will overwrite the file content. |
| `encoding` | string | no | `text` or `base64`. `text` is default. | | `encoding` | string | no | `text` or `base64`. `text` is default. |
| `last_commit_id` | string | no | Last known file commit id. Will be only considered in update, move and delete actions. | | `last_commit_id` | string | no | Last known file commit ID. Will be only considered in update, move, and delete actions. |
| `execute_filemode` | boolean | no | When `true/false` enables/disables the execute flag on the file. Only considered for `chmod` action. | | `execute_filemode` | boolean | no | When `true/false` enables/disables the execute flag on the file. Only considered for `chmod` action. |
```shell ```shell
......
...@@ -249,7 +249,7 @@ POST /groups/:id/epics ...@@ -249,7 +249,7 @@ POST /groups/:id/epics
| `start_date_fixed` | string | no | The fixed start date of an epic (since 11.3) | | `start_date_fixed` | string | no | The fixed start date of an epic (since 11.3) |
| `due_date_is_fixed` | boolean | no | Whether due date should be sourced from `due_date_fixed` or from milestones (since 11.3) | | `due_date_is_fixed` | boolean | no | Whether due date should be sourced from `due_date_fixed` or from milestones (since 11.3) |
| `due_date_fixed` | string | no | The fixed due date of an epic (since 11.3) | | `due_date_fixed` | string | no | The fixed due date of an epic (since 11.3) |
| `parent_id` | integer/string | no | The id of a parent epic (since 11.11) | | `parent_id` | integer/string | no | The ID of a parent epic (since 11.11) |
```shell ```shell
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/1/epics?title=Epic&description=Epic%20description curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/1/epics?title=Epic&description=Epic%20description
......
...@@ -7,7 +7,7 @@ ...@@ -7,7 +7,7 @@
Badges support placeholders that will be replaced in real time in both the link and image URL. The allowed placeholders are: Badges support placeholders that will be replaced in real time in both the link and image URL. The allowed placeholders are:
- **%{project_path}**: will be replaced by the project path. - **%{project_path}**: will be replaced by the project path.
- **%{project_id}**: will be replaced by the project id. - **%{project_id}**: will be replaced by the project ID.
- **%{default_branch}**: will be replaced by the project default branch. - **%{default_branch}**: will be replaced by the project default branch.
- **%{commit_sha}**: will be replaced by the last project's commit SHA. - **%{commit_sha}**: will be replaced by the last project's commit SHA.
......
...@@ -543,8 +543,8 @@ GET /projects/:id/jobs/:job_id/trace ...@@ -543,8 +543,8 @@ GET /projects/:id/jobs/:job_id/trace
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
|-----------|----------------|----------|------------------------------------------------------------------------------------------------------------------| |-----------|----------------|----------|------------------------------------------------------------------------------------------------------------------|
| id | integer/string | yes | ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user. | | `id` | integer/string | yes | ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user. |
| job_id | integer | yes | ID of a job. | | `job_id` | integer | yes | ID of a job. |
```shell ```shell
curl --location --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/jobs/8/trace" curl --location --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/jobs/8/trace"
......
...@@ -90,7 +90,7 @@ Example response: ...@@ -90,7 +90,7 @@ Example response:
## Delete a managed license ## Delete a managed license
Deletes a managed license with a given id. Deletes a managed license with a given ID.
```plaintext ```plaintext
DELETE /projects/:id/managed_licenses/:managed_license_id DELETE /projects/:id/managed_licenses/:managed_license_id
......
...@@ -972,7 +972,7 @@ POST /projects/:id/merge_requests ...@@ -972,7 +972,7 @@ POST /projects/:id/merge_requests
| `assignee_id` | integer | no | Assignee user ID | | `assignee_id` | integer | no | Assignee user ID |
| `assignee_ids` | integer array | no | The ID of the user(s) to assign the MR to. Set to `0` or provide an empty value to unassign all assignees. | | `assignee_ids` | integer array | no | The ID of the user(s) to assign the MR to. Set to `0` or provide an empty value to unassign all assignees. |
| `description` | string | no | Description of MR. Limited to 1,048,576 characters. | | `description` | string | no | Description of MR. Limited to 1,048,576 characters. |
| `target_project_id` | integer | no | The target project (numeric id) | | `target_project_id` | integer | no | The target project (numeric ID) |
| `labels` | string | no | Labels for MR as a comma-separated list | | `labels` | string | no | Labels for MR as a comma-separated list |
| `milestone_id` | integer | no | The global ID of a milestone | | `milestone_id` | integer | no | The global ID of a milestone |
| `remove_source_branch` | boolean | no | Flag indicating if a merge request should remove the source branch when merging | | `remove_source_branch` | boolean | no | Flag indicating if a merge request should remove the source branch when merging |
......
...@@ -54,7 +54,7 @@ GET /projects/:id/pipeline_schedules/:pipeline_schedule_id ...@@ -54,7 +54,7 @@ GET /projects/:id/pipeline_schedules/:pipeline_schedule_id
| Attribute | Type | required | Description | | Attribute | Type | required | Description |
|--------------|---------|----------|--------------------------| |--------------|---------|----------|--------------------------|
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
| `pipeline_schedule_id` | integer | yes | The pipeline schedule id | | `pipeline_schedule_id` | integer | yes | The pipeline schedule ID |
```shell ```shell
curl --header "PRIVATE-TOKEN: k5ESFgWY2Qf5xEvDcFxZ" "https://gitlab.example.com/api/v4/projects/29/pipeline_schedules/13" curl --header "PRIVATE-TOKEN: k5ESFgWY2Qf5xEvDcFxZ" "https://gitlab.example.com/api/v4/projects/29/pipeline_schedules/13"
...@@ -150,7 +150,7 @@ PUT /projects/:id/pipeline_schedules/:pipeline_schedule_id ...@@ -150,7 +150,7 @@ PUT /projects/:id/pipeline_schedules/:pipeline_schedule_id
| Attribute | Type | required | Description | | Attribute | Type | required | Description |
|---------------|---------|----------|--------------------------| |---------------|---------|----------|--------------------------|
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
| `pipeline_schedule_id` | integer | yes | The pipeline schedule id | | `pipeline_schedule_id` | integer | yes | The pipeline schedule ID |
| `description` | string | no | The description of pipeline schedule | | `description` | string | no | The description of pipeline schedule |
| `ref` | string | no | The branch/tag name will be triggered | | `ref` | string | no | The branch/tag name will be triggered |
| `cron` | string | no | The cron (e.g. `0 1 * * *`) ([Cron syntax](https://en.wikipedia.org/wiki/Cron)) | | `cron` | string | no | The cron (e.g. `0 1 * * *`) ([Cron syntax](https://en.wikipedia.org/wiki/Cron)) |
...@@ -200,7 +200,7 @@ POST /projects/:id/pipeline_schedules/:pipeline_schedule_id/take_ownership ...@@ -200,7 +200,7 @@ POST /projects/:id/pipeline_schedules/:pipeline_schedule_id/take_ownership
| Attribute | Type | required | Description | | Attribute | Type | required | Description |
|---------------|---------|----------|--------------------------| |---------------|---------|----------|--------------------------|
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
| `pipeline_schedule_id` | integer | yes | The pipeline schedule id | | `pipeline_schedule_id` | integer | yes | The pipeline schedule ID |
```shell ```shell
curl --request POST --header "PRIVATE-TOKEN: hf2CvZXB9w8Uc5pZKpSB" "https://gitlab.example.com/api/v4/projects/29/pipeline_schedules/13/take_ownership" curl --request POST --header "PRIVATE-TOKEN: hf2CvZXB9w8Uc5pZKpSB" "https://gitlab.example.com/api/v4/projects/29/pipeline_schedules/13/take_ownership"
...@@ -245,7 +245,7 @@ DELETE /projects/:id/pipeline_schedules/:pipeline_schedule_id ...@@ -245,7 +245,7 @@ DELETE /projects/:id/pipeline_schedules/:pipeline_schedule_id
| Attribute | Type | required | Description | | Attribute | Type | required | Description |
|----------------|---------|----------|--------------------------| |----------------|---------|----------|--------------------------|
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
| `pipeline_schedule_id` | integer | yes | The pipeline schedule id | | `pipeline_schedule_id` | integer | yes | The pipeline schedule ID |
```shell ```shell
curl --request DELETE --header "PRIVATE-TOKEN: k5ESFgWY2Qf5xEvDcFxZ" "https://gitlab.example.com/api/v4/projects/29/pipeline_schedules/13" curl --request DELETE --header "PRIVATE-TOKEN: k5ESFgWY2Qf5xEvDcFxZ" "https://gitlab.example.com/api/v4/projects/29/pipeline_schedules/13"
...@@ -293,7 +293,7 @@ POST /projects/:id/pipeline_schedules/:pipeline_schedule_id/play ...@@ -293,7 +293,7 @@ POST /projects/:id/pipeline_schedules/:pipeline_schedule_id/play
| Attribute | Type | required | Description | | Attribute | Type | required | Description |
| ---------------- | --------- | ---------- | -------------------------- | | ---------------- | --------- | ---------- | -------------------------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
| `pipeline_schedule_id` | integer | yes | The pipeline schedule id | | `pipeline_schedule_id` | integer | yes | The pipeline schedule ID |
Example request: Example request:
...@@ -324,7 +324,7 @@ POST /projects/:id/pipeline_schedules/:pipeline_schedule_id/variables ...@@ -324,7 +324,7 @@ POST /projects/:id/pipeline_schedules/:pipeline_schedule_id/variables
| Attribute | Type | required | Description | | Attribute | Type | required | Description |
|------------------------|----------------|----------|--------------------------| |------------------------|----------------|----------|--------------------------|
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
| `pipeline_schedule_id` | integer | yes | The pipeline schedule id | | `pipeline_schedule_id` | integer | yes | The pipeline schedule ID |
| `key` | string | yes | The `key` of a variable; must have no more than 255 characters; only `A-Z`, `a-z`, `0-9`, and `_` are allowed | | `key` | string | yes | The `key` of a variable; must have no more than 255 characters; only `A-Z`, `a-z`, `0-9`, and `_` are allowed |
| `value` | string | yes | The `value` of a variable | | `value` | string | yes | The `value` of a variable |
| `variable_type` | string | no | The type of a variable. Available types are: `env_var` (default) and `file` | | `variable_type` | string | no | The type of a variable. Available types are: `env_var` (default) and `file` |
...@@ -352,7 +352,7 @@ PUT /projects/:id/pipeline_schedules/:pipeline_schedule_id/variables/:key ...@@ -352,7 +352,7 @@ PUT /projects/:id/pipeline_schedules/:pipeline_schedule_id/variables/:key
| Attribute | Type | required | Description | | Attribute | Type | required | Description |
|------------------------|----------------|----------|--------------------------| |------------------------|----------------|----------|--------------------------|
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
| `pipeline_schedule_id` | integer | yes | The pipeline schedule id | | `pipeline_schedule_id` | integer | yes | The pipeline schedule ID |
| `key` | string | yes | The `key` of a variable | | `key` | string | yes | The `key` of a variable |
| `value` | string | yes | The `value` of a variable | | `value` | string | yes | The `value` of a variable |
| `variable_type` | string | no | The type of a variable. Available types are: `env_var` (default) and `file` | | `variable_type` | string | no | The type of a variable. Available types are: `env_var` (default) and `file` |
...@@ -380,7 +380,7 @@ DELETE /projects/:id/pipeline_schedules/:pipeline_schedule_id/variables/:key ...@@ -380,7 +380,7 @@ DELETE /projects/:id/pipeline_schedules/:pipeline_schedule_id/variables/:key
| Attribute | Type | required | Description | | Attribute | Type | required | Description |
|------------------------|----------------|----------|--------------------------| |------------------------|----------------|----------|--------------------------|
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
| `pipeline_schedule_id` | integer | yes | The pipeline schedule id | | `pipeline_schedule_id` | integer | yes | The pipeline schedule ID |
| `key` | string | yes | The `key` of a variable | | `key` | string | yes | The `key` of a variable |
```shell ```shell
......
...@@ -43,7 +43,7 @@ GET /projects/:id/triggers/:trigger_id ...@@ -43,7 +43,7 @@ GET /projects/:id/triggers/:trigger_id
| Attribute | Type | required | Description | | Attribute | Type | required | Description |
|--------------|---------|----------|--------------------------| |--------------|---------|----------|--------------------------|
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
| `trigger_id` | integer | yes | The trigger id | | `trigger_id` | integer | yes | The trigger ID |
```shell ```shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/triggers/5" curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/triggers/5"
...@@ -101,7 +101,7 @@ PUT /projects/:id/triggers/:trigger_id ...@@ -101,7 +101,7 @@ PUT /projects/:id/triggers/:trigger_id
| Attribute | Type | required | Description | | Attribute | Type | required | Description |
|---------------|---------|----------|--------------------------| |---------------|---------|----------|--------------------------|
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
| `trigger_id` | integer | yes | The trigger id | | `trigger_id` | integer | yes | The trigger ID |
| `description` | string | no | The trigger name | | `description` | string | no | The trigger name |
```shell ```shell
...@@ -131,7 +131,7 @@ DELETE /projects/:id/triggers/:trigger_id ...@@ -131,7 +131,7 @@ DELETE /projects/:id/triggers/:trigger_id
| Attribute | Type | required | Description | | Attribute | Type | required | Description |
|----------------|---------|----------|--------------------------| |----------------|---------|----------|--------------------------|
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
| `trigger_id` | integer | yes | The trigger id | | `trigger_id` | integer | yes | The trigger ID |
```shell ```shell
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/triggers/5" curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/triggers/5"
......
...@@ -7,7 +7,7 @@ ...@@ -7,7 +7,7 @@
Badges support placeholders that will be replaced in real time in both the link and image URL. The allowed placeholders are: Badges support placeholders that will be replaced in real time in both the link and image URL. The allowed placeholders are:
- **%{project_path}**: will be replaced by the project path. - **%{project_path}**: will be replaced by the project path.
- **%{project_id}**: will be replaced by the project id. - **%{project_id}**: will be replaced by the project ID.
- **%{default_branch}**: will be replaced by the project default branch. - **%{default_branch}**: will be replaced by the project default branch.
- **%{commit_sha}**: will be replaced by the last project's commit sha. - **%{commit_sha}**: will be replaced by the last project's commit sha.
......
...@@ -55,7 +55,7 @@ GET /projects/:id/releases/:tag_name/assets/links/:link_id ...@@ -55,7 +55,7 @@ GET /projects/:id/releases/:tag_name/assets/links/:link_id
| ------------- | -------------- | -------- | --------------------------------------- | | ------------- | -------------- | -------- | --------------------------------------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](../README.md#namespaced-path-encoding). | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](../README.md#namespaced-path-encoding). |
| `tag_name` | string | yes | The tag associated with the Release. | | `tag_name` | string | yes | The tag associated with the Release. |
| `link_id` | integer | yes | The id of the link. | | `link_id` | integer | yes | The ID of the link. |
Example request: Example request:
...@@ -122,7 +122,7 @@ PUT /projects/:id/releases/:tag_name/assets/links/:link_id ...@@ -122,7 +122,7 @@ PUT /projects/:id/releases/:tag_name/assets/links/:link_id
| ------------- | -------------- | -------- | --------------------------------------- | | ------------- | -------------- | -------- | --------------------------------------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](../README.md#namespaced-path-encoding). | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](../README.md#namespaced-path-encoding). |
| `tag_name` | string | yes | The tag associated with the Release. | | `tag_name` | string | yes | The tag associated with the Release. |
| `link_id` | integer | yes | The id of the link. | | `link_id` | integer | yes | The ID of the link. |
| `name` | string | no | The name of the link. | | `name` | string | no | The name of the link. |
| `url` | string | no | The URL of the link. | | `url` | string | no | The URL of the link. |
...@@ -158,7 +158,7 @@ DELETE /projects/:id/releases/:tag_name/assets/links/:link_id ...@@ -158,7 +158,7 @@ DELETE /projects/:id/releases/:tag_name/assets/links/:link_id
| ------------- | -------------- | -------- | --------------------------------------- | | ------------- | -------------- | -------- | --------------------------------------- |
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](../README.md#namespaced-path-encoding). | | `id` | integer/string | yes | The ID or [URL-encoded path of the project](../README.md#namespaced-path-encoding). |
| `tag_name` | string | yes | The tag associated with the Release. | | `tag_name` | string | yes | The tag associated with the Release. |
| `link_id` | integer | yes | The id of the link. | | `link_id` | integer | yes | The ID of the link. |
Example request: Example request:
......
...@@ -236,7 +236,7 @@ Parameters: ...@@ -236,7 +236,7 @@ Parameters:
- `author_name` (optional) - Specify the commit author's name - `author_name` (optional) - Specify the commit author's name
- `content` (required) - New file content - `content` (required) - New file content
- `commit_message` (required) - Commit message - `commit_message` (required) - Commit message
- `last_commit_id` (optional) - Last known file commit id - `last_commit_id` (optional) - Last known file commit ID
If the commit fails for any reason we return a 400 error with a non-specific If the commit fails for any reason we return a 400 error with a non-specific
error message. Possible causes for a failed commit include: error message. Possible causes for a failed commit include:
...@@ -271,4 +271,4 @@ Parameters: ...@@ -271,4 +271,4 @@ Parameters:
- `author_email` (optional) - Specify the commit author's email address - `author_email` (optional) - Specify the commit author's email address
- `author_name` (optional) - Specify the commit author's name - `author_name` (optional) - Specify the commit author's name
- `commit_message` (required) - Commit message - `commit_message` (required) - Commit message
- `last_commit_id` (optional) - Last known file commit id - `last_commit_id` (optional) - Last known file commit ID
...@@ -158,13 +158,13 @@ Returns a `201` status code if successful. ...@@ -158,13 +158,13 @@ Returns a `201` status code if successful.
Fields that can be updated are: Fields that can be updated are:
| SCIM/IdP field | GitLab field | | SCIM/IdP field | GitLab field |
|:----------|:--------| |:---------------------------------|:---------------------------------------|
| id/externalId | extern_uid | | `id/externalId` | `extern_uid` |
| name.formatted | name | | `name.formatted` | `name` |
| emails\[type eq "work"\].value | email | | `emails\[type eq "work"\].value` | `email` |
| active | Identity removal if `active = false` | | `active` | Identity removal if `active` = `false` |
| userName | username | | `userName` | `username` |
```text ```text
PATCH /api/scim/v2/groups/:group_path/Users/:id PATCH /api/scim/v2/groups/:group_path/Users/:id
......
...@@ -331,13 +331,13 @@ are listed in the descriptions of the relevant settings. ...@@ -331,13 +331,13 @@ are listed in the descriptions of the relevant settings.
| `sign_in_text` | string | no | Text on the login page. | | `sign_in_text` | string | no | Text on the login page. |
| `signup_enabled` | boolean | no | Enable registration. Default is `true`. | | `signup_enabled` | boolean | no | Enable registration. Default is `true`. |
| `slack_app_enabled` | boolean | no | **(PREMIUM)** (**If enabled, requires:** `slack_app_id`, `slack_app_secret` and `slack_app_secret`) Enable Slack app. | | `slack_app_enabled` | boolean | no | **(PREMIUM)** (**If enabled, requires:** `slack_app_id`, `slack_app_secret` and `slack_app_secret`) Enable Slack app. |
| `slack_app_id` | string | required by: `slack_app_enabled` | **(PREMIUM)** The app id of the Slack-app. | | `slack_app_id` | string | required by: `slack_app_enabled` | **(PREMIUM)** The app ID of the Slack-app. |
| `slack_app_secret` | string | required by: `slack_app_enabled` | **(PREMIUM)** The app secret of the Slack-app. | | `slack_app_secret` | string | required by: `slack_app_enabled` | **(PREMIUM)** The app secret of the Slack-app. |
| `slack_app_verification_token` | string | required by: `slack_app_enabled` | **(PREMIUM)** The verification token of the Slack-app. | | `slack_app_verification_token` | string | required by: `slack_app_enabled` | **(PREMIUM)** The verification token of the Slack-app. |
| `snowplow_collector_hostname` | string | required by: `snowplow_enabled` | The Snowplow collector hostname. (for example, `snowplow.trx.gitlab.net`) | | `snowplow_collector_hostname` | string | required by: `snowplow_enabled` | The Snowplow collector hostname. (for example, `snowplow.trx.gitlab.net`) |
| `snowplow_cookie_domain` | string | no | The Snowplow cookie domain. (for example, `.gitlab.com`) | | `snowplow_cookie_domain` | string | no | The Snowplow cookie domain. (for example, `.gitlab.com`) |
| `snowplow_enabled` | boolean | no | Enable snowplow tracking. | | `snowplow_enabled` | boolean | no | Enable snowplow tracking. |
| `snowplow_app_id` | string | no | The Snowplow site name / application id. (for example, `gitlab`) | | `snowplow_app_id` | string | no | The Snowplow site name / application ID. (for example, `gitlab`) |
| `snowplow_iglu_registry_url` | string | no | The Snowplow base Iglu Schema Registry URL to use for custom context and self describing events'| | `snowplow_iglu_registry_url` | string | no | The Snowplow base Iglu Schema Registry URL to use for custom context and self describing events'|
| `sourcegraph_enabled` | boolean | no | Enables Sourcegraph integration. Default is `false`. **If enabled, requires** `sourcegraph_url`. | | `sourcegraph_enabled` | boolean | no | Enables Sourcegraph integration. Default is `false`. **If enabled, requires** `sourcegraph_url`. |
| `sourcegraph_url` | string | required by: `sourcegraph_enabled` | The Sourcegraph instance URL for integration. | | `sourcegraph_url` | string | required by: `sourcegraph_enabled` | The Sourcegraph instance URL for integration. |
......
...@@ -611,7 +611,7 @@ GET /users/:id_or_username/status ...@@ -611,7 +611,7 @@ GET /users/:id_or_username/status
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
| ---------------- | ------ | -------- | ----------- | | ---------------- | ------ | -------- | ----------- |
| `id_or_username` | string | yes | The id or username of the user to get a status of | | `id_or_username` | string | yes | The ID or username of the user to get a status of |
```shell ```shell
curl "https://gitlab.example.com/users/janedoe/status" curl "https://gitlab.example.com/users/janedoe/status"
...@@ -723,7 +723,7 @@ GET /users/:id_or_username/keys ...@@ -723,7 +723,7 @@ GET /users/:id_or_username/keys
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
| ---------------- | ------ | -------- | ----------- | | ---------------- | ------ | -------- | ----------- |
| `id_or_username` | string | yes | The id or username of the user to get the SSH keys for. | | `id_or_username` | string | yes | The ID or username of the user to get the SSH keys for. |
## Single SSH key ## Single SSH key
...@@ -794,7 +794,7 @@ POST /users/:id/keys ...@@ -794,7 +794,7 @@ POST /users/:id/keys
Parameters: Parameters:
- `id` (required) - id of specified user - `id` (required) - ID of specified user
- `title` (required) - new SSH Key's title - `title` (required) - new SSH Key's title
- `key` (required) - new SSH key - `key` (required) - new SSH key
...@@ -821,7 +821,7 @@ DELETE /users/:id/keys/:key_id ...@@ -821,7 +821,7 @@ DELETE /users/:id/keys/:key_id
Parameters: Parameters:
- `id` (required) - id of specified user - `id` (required) - ID of specified user
- `key_id` (required) - SSH key ID - `key_id` (required) - SSH key ID
## List all GPG keys ## List all GPG keys
...@@ -1070,7 +1070,7 @@ GET /users/:id/emails ...@@ -1070,7 +1070,7 @@ GET /users/:id/emails
Parameters: Parameters:
- `id` (required) - id of specified user - `id` (required) - ID of specified user
## Single email ## Single email
...@@ -1133,7 +1133,7 @@ POST /users/:id/emails ...@@ -1133,7 +1133,7 @@ POST /users/:id/emails
Parameters: Parameters:
- `id` (required) - id of specified user - `id` (required) - ID of specified user
- `email` (required) - email address - `email` (required) - email address
- `skip_confirmation` (optional) - Skip confirmation and assume e-mail is verified - true or false (default) - `skip_confirmation` (optional) - Skip confirmation and assume e-mail is verified - true or false (default)
...@@ -1160,7 +1160,7 @@ DELETE /users/:id/emails/:email_id ...@@ -1160,7 +1160,7 @@ DELETE /users/:id/emails/:email_id
Parameters: Parameters:
- `id` (required) - id of specified user - `id` (required) - ID of specified user
- `email_id` (required) - email ID - `email_id` (required) - email ID
## Block user ## Block user
...@@ -1173,7 +1173,7 @@ POST /users/:id/block ...@@ -1173,7 +1173,7 @@ POST /users/:id/block
Parameters: Parameters:
- `id` (required) - id of specified user - `id` (required) - ID of specified user
Returns: Returns:
...@@ -1191,7 +1191,7 @@ POST /users/:id/unblock ...@@ -1191,7 +1191,7 @@ POST /users/:id/unblock
Parameters: Parameters:
- `id` (required) - id of specified user - `id` (required) - ID of specified user
Will return `201 OK` on success, `404 User Not Found` is user cannot be found or Will return `201 OK` on success, `404 User Not Found` is user cannot be found or
`403 Forbidden` when trying to unblock a user blocked by LDAP synchronization. `403 Forbidden` when trying to unblock a user blocked by LDAP synchronization.
...@@ -1208,7 +1208,7 @@ POST /users/:id/deactivate ...@@ -1208,7 +1208,7 @@ POST /users/:id/deactivate
Parameters: Parameters:
- `id` (required) - id of specified user - `id` (required) - ID of specified user
Returns: Returns:
...@@ -1230,7 +1230,7 @@ POST /users/:id/activate ...@@ -1230,7 +1230,7 @@ POST /users/:id/activate
Parameters: Parameters:
- `id` (required) - id of specified user - `id` (required) - ID of specified user
Returns: Returns:
......
...@@ -417,7 +417,7 @@ credentials, which will be the same two credentials (Key ID and Secret). It's a ...@@ -417,7 +417,7 @@ credentials, which will be the same two credentials (Key ID and Secret). It's a
fully understand [IAM Best Practices in AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html). We need to add these credentials to GitLab: fully understand [IAM Best Practices in AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html). We need to add these credentials to GitLab:
1. Log into your AWS account and go to the [Security Credentials page](https://console.aws.amazon.com/iam/home#/security_credential) 1. Log into your AWS account and go to the [Security Credentials page](https://console.aws.amazon.com/iam/home#/security_credential)
1. Click the **Access Keys** section and **Create New Access Key**. Create the key and keep the id and secret around, you'll need them later 1. Click the **Access Keys** section and **Create New Access Key**. Create the key and keep the ID and secret around, you'll need them later
![AWS Access Key Config](img/aws_config_window.png) ![AWS Access Key Config](img/aws_config_window.png)
...@@ -426,7 +426,7 @@ fully understand [IAM Best Practices in AWS](https://docs.aws.amazon.com/IAM/lat ...@@ -426,7 +426,7 @@ fully understand [IAM Best Practices in AWS](https://docs.aws.amazon.com/IAM/lat
![GitLab Secret Config](img/gitlab_config.png) ![GitLab Secret Config](img/gitlab_config.png)
1. Add a key named `AWS_KEY_ID` and copy the key id from Step 2 into the **Value** textbox 1. Add a key named `AWS_KEY_ID` and copy the key ID from Step 2 into the **Value** textbox
1. Add a key named `AWS_KEY_SECRET` and copy the key secret from Step 2 into the **Value** textbox 1. Add a key named `AWS_KEY_SECRET` and copy the key secret from Step 2 into the **Value** textbox
### Deploy your game with GitLab CI/CD ### Deploy your game with GitLab CI/CD
......
This diff is collapsed.
...@@ -1641,7 +1641,7 @@ curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --form "title= ...@@ -1641,7 +1641,7 @@ curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --form "title=
``` ```
The above example is run by and administrator and will add an SSH public key The above example is run by and administrator and will add an SSH public key
titled `ssh-key` to user's account which has an id of 25. titled `ssh-key` to user's account which has an ID of 25.
#### Escape special characters #### Escape special characters
......
...@@ -85,7 +85,7 @@ for the format of the email key: ...@@ -85,7 +85,7 @@ for the format of the email key:
- Actions are always at the end, separated by `-`. For example `-issue` or `-merge-request` - Actions are always at the end, separated by `-`. For example `-issue` or `-merge-request`
- If your feature is related to a project, the key begins with the project identifiers (project path slug - If your feature is related to a project, the key begins with the project identifiers (project path slug
and project id), separated by `-`. For example, `gitlab-org-gitlab-foss-20` and project ID), separated by `-`. For example, `gitlab-org-gitlab-foss-20`
- Additional information, such as an author's token, can be added between the project identifiers and - Additional information, such as an author's token, can be added between the project identifiers and
the action, separated by `-`. For example, `gitlab-org-gitlab-foss-20-Author_Token12345678-issue` the action, separated by `-`. For example, `gitlab-org-gitlab-foss-20-Author_Token12345678-issue`
- You register your handlers in `lib/gitlab/email/handler.rb` - You register your handlers in `lib/gitlab/email/handler.rb`
......
...@@ -325,7 +325,7 @@ When using `v-for` you need to provide a *unique* `:key` attribute for each item ...@@ -325,7 +325,7 @@ When using `v-for` you need to provide a *unique* `:key` attribute for each item
</div> </div>
``` ```
1. When the elements being iterated don't have a unique id, you can use the array index as the `:key` attribute 1. When the elements being iterated don't have a unique ID, you can use the array index as the `:key` attribute
```html ```html
<div <div
......
...@@ -30,18 +30,18 @@ they are still not 100% standardized. You can see them below: ...@@ -30,18 +30,18 @@ they are still not 100% standardized. You can see them below:
| Description | In DB? | Relative path (from CarrierWave.root) | Uploader class | model_type | | Description | In DB? | Relative path (from CarrierWave.root) | Uploader class | model_type |
| ------------------------------------- | ------ | ----------------------------------------------------------- | ---------------------- | ---------- | | ------------------------------------- | ------ | ----------------------------------------------------------- | ---------------------- | ---------- |
| Instance logo | yes | uploads/-/system/appearance/logo/:id/:filename | `AttachmentUploader` | Appearance | | Instance logo | yes | `uploads/-/system/appearance/logo/:id/:filename` | `AttachmentUploader` | Appearance |
| Header logo | yes | uploads/-/system/appearance/header_logo/:id/:filename | `AttachmentUploader` | Appearance | | Header logo | yes | `uploads/-/system/appearance/header_logo/:id/:filename` | `AttachmentUploader` | Appearance |
| Group avatars | yes | uploads/-/system/group/avatar/:id/:filename | `AvatarUploader` | Group | | Group avatars | yes | `uploads/-/system/group/avatar/:id/:filename` | `AvatarUploader` | Group |
| User avatars | yes | uploads/-/system/user/avatar/:id/:filename | `AvatarUploader` | User | | User avatars | yes | `uploads/-/system/user/avatar/:id/:filename` | `AvatarUploader` | User |
| User snippet attachments | yes | uploads/-/system/personal_snippet/:id/:random_hex/:filename | `PersonalFileUploader` | Snippet | | User snippet attachments | yes | `uploads/-/system/personal_snippet/:id/:random_hex/:filename` | `PersonalFileUploader` | Snippet |
| Project avatars | yes | uploads/-/system/project/avatar/:id/:filename | `AvatarUploader` | Project | | Project avatars | yes | `uploads/-/system/project/avatar/:id/:filename` | `AvatarUploader` | Project |
| Issues/MR/Notes Markdown attachments | yes | uploads/:project_path_with_namespace/:random_hex/:filename | `FileUploader` | Project | | Issues/MR/Notes Markdown attachments | yes | `uploads/:project_path_with_namespace/:random_hex/:filename` | `FileUploader` | Project |
| Issues/MR/Notes Legacy Markdown attachments | no | uploads/-/system/note/attachment/:id/:filename | `AttachmentUploader` | Note | | Issues/MR/Notes Legacy Markdown attachments | no | `uploads/-/system/note/attachment/:id/:filename` | `AttachmentUploader` | Note |
| Design Management design thumbnails (EE) | yes | uploads/-/system/design_management/action/image_v432x230/:id/:filename | `DesignManagement::DesignV432x230Uploader` | DesignManagement::Action | | Design Management design thumbnails (EE) | yes | `uploads/-/system/design_management/action/image_v432x230/:id/:filename` | `DesignManagement::DesignV432x230Uploader` | DesignManagement::Action |
| CI Artifacts (CE) | yes | `shared/artifacts/:disk_hash[0..1]/:disk_hash[2..3]/:disk_hash/:year_:month_:date/:job_id/:job_artifact_id` (:disk_hash is SHA256 digest of project_id) | `JobArtifactUploader` | Ci::JobArtifact | | CI Artifacts (CE) | yes | `shared/artifacts/:disk_hash[0..1]/:disk_hash[2..3]/:disk_hash/:year_:month_:date/:job_id/:job_artifact_id` (`:disk_hash` is SHA256 digest of `project_id`) | `JobArtifactUploader` | Ci::JobArtifact |
| LFS Objects (CE) | yes | shared/lfs-objects/:hex/:hex/:object_hash | `LfsObjectUploader` | LfsObject | | LFS Objects (CE) | yes | `shared/lfs-objects/:hex/:hex/:object_hash` | `LfsObjectUploader` | LfsObject |
| External merge request diffs | yes | shared/external-diffs/merge_request_diffs/mr-:parent_id/diff-:id | `ExternalDiffUploader` | MergeRequestDiff | | External merge request diffs | yes | `shared/external-diffs/merge_request_diffs/mr-:parent_id/diff-:id` | `ExternalDiffUploader` | MergeRequestDiff |
CI Artifacts and LFS Objects behave differently in CE and EE. In CE they inherit the `GitlabUploader` CI Artifacts and LFS Objects behave differently in CE and EE. In CE they inherit the `GitlabUploader`
while in EE they inherit the `ObjectStorage` and store files in and S3 API compatible object store. while in EE they inherit the `ObjectStorage` and store files in and S3 API compatible object store.
......
...@@ -536,9 +536,9 @@ The linter will take the following into account: ...@@ -536,9 +536,9 @@ The linter will take the following into account:
- Variable usage - Variable usage
- Only one unnamed (`%d`) variable, since the order of variables might change - Only one unnamed (`%d`) variable, since the order of variables might change
in different languages in different languages
- All variables used in the message-id are used in the translation - All variables used in the message ID are used in the translation
- There should be no variables used in a translation that aren't in the - There should be no variables used in a translation that aren't in the
message-id message ID
- Errors during translation. - Errors during translation.
The errors are grouped per file, and per message ID: The errors are grouped per file, and per message ID:
...@@ -562,7 +562,7 @@ Errors in `locale/zh_TW/gitlab.po`: ...@@ -562,7 +562,7 @@ Errors in `locale/zh_TW/gitlab.po`:
In this output the `locale/zh_HK/gitlab.po` has syntax errors. In this output the `locale/zh_HK/gitlab.po` has syntax errors.
The `locale/zh_TW/gitlab.po` has variables that are used in the translation that The `locale/zh_TW/gitlab.po` has variables that are used in the translation that
aren't in the message with id `1 pipeline`. aren't in the message with ID `1 pipeline`.
## Adding a new language ## Adding a new language
......
...@@ -40,7 +40,7 @@ POST /internal/allowed ...@@ -40,7 +40,7 @@ POST /internal/allowed
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
|:----------|:-------|:---------|:------------| |:----------|:-------|:---------|:------------|
| `key_id` | string | no | Id of the SSH-key used to connect to GitLab-shell | | `key_id` | string | no | ID of the SSH-key used to connect to GitLab-shell |
| `username` | string | no | Username from the certificate used to connect to GitLab-Shell | | `username` | string | no | Username from the certificate used to connect to GitLab-Shell |
| `project` | string | no (if `gl_repository` is passed) | Path to the project | | `project` | string | no (if `gl_repository` is passed) | Path to the project |
| `gl_repository` | string | no (if `project` is passed) | Path to the project | | `gl_repository` | string | no (if `project` is passed) | Path to the project |
...@@ -93,7 +93,7 @@ information for LFS clients when the repository is accessed over SSH. ...@@ -93,7 +93,7 @@ information for LFS clients when the repository is accessed over SSH.
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
|:----------|:-------|:---------|:------------| |:----------|:-------|:---------|:------------|
| `key_id` | string | no | Id of the SSH-key used to connect to GitLab-shell | | `key_id` | string | no | ID of the SSH-key used to connect to GitLab-shell |
| `username`| string | no | Username from the certificate used to connect to GitLab-Shell | | `username`| string | no | Username from the certificate used to connect to GitLab-Shell |
| `project` | string | no | Path to the project | | `project` | string | no | Path to the project |
...@@ -151,14 +151,14 @@ Example response: ...@@ -151,14 +151,14 @@ Example response:
- GitLab-shell - GitLab-shell
## Get user for user id or key ## Get user for user ID or key
This endpoint is used when a user performs `ssh git@gitlab.com`. It This endpoint is used when a user performs `ssh git@gitlab.com`. It
discovers the user associated with an SSH key. discovers the user associated with an SSH key.
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
|:----------|:-------|:---------|:------------| |:----------|:-------|:---------|:------------|
| `key_id` | integer | no | The id of the SSH key used as found in the authorized-keys file or through the `/authorized_keys` check | | `key_id` | integer | no | The ID of the SSH key used as found in the authorized-keys file or through the `/authorized_keys` check |
| `username` | string | no | Username of the user being looked up, used by GitLab-shell when authenticating using a certificate | | `username` | string | no | Username of the user being looked up, used by GitLab-shell when authenticating using a certificate |
```plaintext ```plaintext
...@@ -223,7 +223,7 @@ recovery codes based on their SSH key ...@@ -223,7 +223,7 @@ recovery codes based on their SSH key
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
|:----------|:-------|:---------|:------------| |:----------|:-------|:---------|:------------|
| `key_id` | integer | no | The id of the SSH key used as found in the authorized-keys file or through the `/authorized_keys` check | | `key_id` | integer | no | The ID of the SSH key used as found in the authorized-keys file or through the `/authorized_keys` check |
| `user_id` | integer | no | **Deprecated** User_id for which to generate new recovery codes | | `user_id` | integer | no | **Deprecated** User_id for which to generate new recovery codes |
```plaintext ```plaintext
......
...@@ -111,11 +111,11 @@ Directly relate the root namespace to its child namespaces, so ...@@ -111,11 +111,11 @@ Directly relate the root namespace to its child namespaces, so
whenever a namespace is created without a parent, this one is tagged whenever a namespace is created without a parent, this one is tagged
with the root namespace ID: with the root namespace ID:
| id | root_id | parent_id | ID | root ID | parent ID |
|:---|:--------|:---------- |:---|:--------|:----------|
| 1 | 1 | NULL | 1 | 1 | NULL |
| 2 | 1 | 1 | 2 | 1 | 1 |
| 3 | 1 | 2 | 3 | 1 | 2 |
To aggregate the statistics inside a namespace we'd execute something like: To aggregate the statistics inside a namespace we'd execute something like:
......
...@@ -77,64 +77,64 @@ always be at the end of a table. ...@@ -77,64 +77,64 @@ always be at the end of a table.
Let's use the `events` table as an example, which currently has the following Let's use the `events` table as an example, which currently has the following
layout: layout:
| Column | Type | Size | | Column | Type | Size |
|:------------|:----------------------------|:---------| |:--------------|:----------------------------|:---------|
| id | integer | 4 bytes | | `id` | integer | 4 bytes |
| target_type | character varying | variable | | `target_type` | character varying | variable |
| target_id | integer | 4 bytes | | `target_id` | integer | 4 bytes |
| title | character varying | variable | | `title` | character varying | variable |
| data | text | variable | | `data` | text | variable |
| project_id | integer | 4 bytes | | `project_id` | integer | 4 bytes |
| created_at | timestamp without time zone | 8 bytes | | `created_at` | timestamp without time zone | 8 bytes |
| updated_at | timestamp without time zone | 8 bytes | | `updated_at` | timestamp without time zone | 8 bytes |
| action | integer | 4 bytes | | `action` | integer | 4 bytes |
| author_id | integer | 4 bytes | | `author_id` | integer | 4 bytes |
After adding padding to align the columns this would translate to columns being After adding padding to align the columns this would translate to columns being
divided into fixed size chunks as follows: divided into fixed size chunks as follows:
| Chunk Size | Columns | | Chunk Size | Columns |
|:-----------|:------------------| |:-----------|:----------------------|
| 8 bytes | id | | 8 bytes | `id` |
| variable | target_type | | variable | `target_type` |
| 8 bytes | target_id | | 8 bytes | `target_id` |
| variable | title | | variable | `title` |
| variable | data | | variable | `data` |
| 8 bytes | project_id | | 8 bytes | `project_id` |
| 8 bytes | created_at | | 8 bytes | `created_at` |
| 8 bytes | updated_at | | 8 bytes | `updated_at` |
| 8 bytes | action, author_id | | 8 bytes | `action`, `author_id` |
This means that excluding the variable sized data and tuple header, we need at This means that excluding the variable sized data and tuple header, we need at
least 8 * 6 = 48 bytes per row. least 8 * 6 = 48 bytes per row.
We can optimise this by using the following column order instead: We can optimise this by using the following column order instead:
| Column | Type | Size | | Column | Type | Size |
|:------------|:----------------------------|:---------| |:--------------|:----------------------------|:---------|
| created_at | timestamp without time zone | 8 bytes | | `created_at` | timestamp without time zone | 8 bytes |
| updated_at | timestamp without time zone | 8 bytes | | `updated_at` | timestamp without time zone | 8 bytes |
| id | integer | 4 bytes | | `id` | integer | 4 bytes |
| target_id | integer | 4 bytes | | `target_id` | integer | 4 bytes |
| project_id | integer | 4 bytes | | `project_id` | integer | 4 bytes |
| action | integer | 4 bytes | | `action` | integer | 4 bytes |
| author_id | integer | 4 bytes | | `author_id` | integer | 4 bytes |
| target_type | character varying | variable | | `target_type` | character varying | variable |
| title | character varying | variable | | `title` | character varying | variable |
| data | text | variable | | `data` | text | variable |
This would produce the following chunks: This would produce the following chunks:
| Chunk Size | Columns | | Chunk Size | Columns |
|:-----------|:-------------------| |:-----------|:-----------------------|
| 8 bytes | created_at | | 8 bytes | `created_at` |
| 8 bytes | updated_at | | 8 bytes | `updated_at` |
| 8 bytes | id, target_id | | 8 bytes | `id`, `target_id` |
| 8 bytes | project_id, action | | 8 bytes | `project_id`, `action` |
| 8 bytes | author_id | | 8 bytes | `author_id` |
| variable | target_type | | variable | `target_type` |
| variable | title | | variable | `title` |
| variable | data | | variable | `data` |
Here we only need 40 bytes per row excluding the variable sized data and 24-byte Here we only need 40 bytes per row excluding the variable sized data and 24-byte
tuple header. 8 bytes being saved may not sound like much, but for tables as tuple header. 8 bytes being saved may not sound like much, but for tables as
......
...@@ -74,7 +74,7 @@ It is using the top-level group or namespace as the defining portion of the name ...@@ -74,7 +74,7 @@ It is using the top-level group or namespace as the defining portion of the name
To avoid name conflict for instance-level endpoints you will need to define a package naming convention To avoid name conflict for instance-level endpoints you will need to define a package naming convention
that gives a way to identify the project that the package belongs to. This generally involves using the project that gives a way to identify the project that the package belongs to. This generally involves using the project
id or full project path in the package name. See ID or full project path in the package name. See
[Conan's naming convention](../user/packages/conan_repository/index.md#package-recipe-naming-convention) as an example. [Conan's naming convention](../user/packages/conan_repository/index.md#package-recipe-naming-convention) as an example.
For group and project-level endpoints, naming can be less constrained and it will be up to the group and project For group and project-level endpoints, naming can be less constrained and it will be up to the group and project
......
...@@ -4,7 +4,7 @@ ...@@ -4,7 +4,7 @@
Rails makes it possible to define so called "polymorphic associations". This Rails makes it possible to define so called "polymorphic associations". This
usually works by adding two columns to a table: a target type column, and a usually works by adding two columns to a table: a target type column, and a
target id. For example, at the time of writing we have such a setup for target ID. For example, at the time of writing we have such a setup for
`members` with the following columns: `members` with the following columns:
- `source_type`: a string defining the model to use, can be either `Project` or - `source_type`: a string defining the model to use, can be either `Project` or
......
...@@ -24,9 +24,8 @@ GitLab.com will generate an application ID and secret key for you to use. ...@@ -24,9 +24,8 @@ GitLab.com will generate an application ID and secret key for you to use.
1. Select **Save application**. 1. Select **Save application**.
1. You should now see a **Application Id** and **Secret** near the top right of the page (see screenshot). 1. You should now see an **Application ID** and **Secret**. Keep this page open as you continue
Keep this page open as you continue configuration. configuration.
![GitLab app](img/gitlab_app.png)
1. On your GitLab server, open the configuration file. 1. On your GitLab server, open the configuration file.
......
...@@ -62,7 +62,7 @@ There are no special requirements if you are using GitLab.com. ...@@ -62,7 +62,7 @@ There are no special requirements if you are using GitLab.com.
- Check `api` in the Scopes section. - Check `api` in the Scopes section.
1. Click `Save application`. You will see the generated 'Application Id' and 'Secret' values. 1. Click `Save application`. You will see the generated 'Application ID' and 'Secret' values.
Copy these values that you will use on the Jira configuration side. Copy these values that you will use on the Jira configuration side.
## Jira Configuration ## Jira Configuration
......
...@@ -14,11 +14,11 @@ Taking the trigger term as `project-name`, the commands are: ...@@ -14,11 +14,11 @@ Taking the trigger term as `project-name`, the commands are:
| ------- | ------ | | ------- | ------ |
| `/project-name help` | Shows all available slash commands | | `/project-name help` | Shows all available slash commands |
| `/project-name issue new <title> <shift+return> <description>` | Creates a new issue with title `<title>` and description `<description>` | | `/project-name issue new <title> <shift+return> <description>` | Creates a new issue with title `<title>` and description `<description>` |
| `/project-name issue show <id>` | Shows the issue with id `<id>` | | `/project-name issue show <id>` | Shows the issue with ID `<id>` |
| `/project-name issue close <id>` | Closes the issue with id `<id>` | | `/project-name issue close <id>` | Closes the issue with ID `<id>` |
| `/project-name issue search <query>` | Shows up to 5 issues matching `<query>` | | `/project-name issue search <query>` | Shows up to 5 issues matching `<query>` |
| `/project-name issue move <id> to <project>` | Moves issue ID `<id>` to `<project>` | | `/project-name issue move <id> to <project>` | Moves issue ID `<id>` to `<project>` |
| `/project-name issue comment <id> <shift+return> <comment>` | Adds a new comment to an issue with id `<id>` and comment body `<comment>` | | `/project-name issue comment <id> <shift+return> <comment>` | Adds a new comment to an issue with ID `<id>` and comment body `<comment>` |
| `/project-name deploy <from> to <to>` | Deploy from the `<from>` environment to the `<to>` environment | | `/project-name deploy <from> to <to>` | Deploy from the `<from>` environment to the `<to>` environment |
| `/project-name run <job name> <arguments>` | Execute [ChatOps](../ci/chatops/README.md) job `<job name>` on `master` | | `/project-name run <job name> <arguments>` | Execute [ChatOps](../ci/chatops/README.md) job `<job name>` on `master` |
......
...@@ -154,7 +154,7 @@ also edit it: ...@@ -154,7 +154,7 @@ also edit it:
git lfs unlock images/banner.png git lfs unlock images/banner.png
``` ```
You can also unlock by id: You can also unlock by ID:
```shell ```shell
git lfs unlock --id=123 git lfs unlock --id=123
......
...@@ -24,7 +24,7 @@ Git is really deleted](https://git-scm.com/book/en/v2/Git-Internals-Maintenance- ...@@ -24,7 +24,7 @@ Git is really deleted](https://git-scm.com/book/en/v2/Git-Internals-Maintenance-
This means that until Git automatically cleans detached commits (which cannot be This means that until Git automatically cleans detached commits (which cannot be
accessed by branch or tag) it will be possible to view them with `git reflog` command accessed by branch or tag) it will be possible to view them with `git reflog` command
and access them with direct commit-id. Read more about _[redoing the undo](#redoing-the-undo)_ on the section below. and access them with direct commit ID. Read more about _[redoing the undo](#redoing-the-undo)_ on the section below.
## Introduction ## Introduction
...@@ -233,7 +233,7 @@ last known good commit (we assume `A`) and first known bad commit (where bug was ...@@ -233,7 +233,7 @@ last known good commit (we assume `A`) and first known bad commit (where bug was
git bisect A..E git bisect A..E
``` ```
Bisect will provide us with commit-id of the middle commit to test, and then guide us Bisect will provide us with commit ID of the middle commit to test, and then guide us
through simple bisection process. You can read more about it [in official Git Tools](https://git-scm.com/book/en/v2/Git-Tools-Debugging-with-Git) through simple bisection process. You can read more about it [in official Git Tools](https://git-scm.com/book/en/v2/Git-Tools-Debugging-with-Git)
In our example we will end up with commit `B`, that introduced bug/error. We have In our example we will end up with commit `B`, that introduced bug/error. We have
4 options on how to remove it (or part of it) from our repository. 4 options on how to remove it (or part of it) from our repository.
...@@ -332,7 +332,7 @@ history](#how-modifying-history-is-done) ...@@ -332,7 +332,7 @@ history](#how-modifying-history-is-done)
Sometimes you realize that the changes you undid were useful and you want them Sometimes you realize that the changes you undid were useful and you want them
back. Well because of first paragraph you are in luck. Command `git reflog` back. Well because of first paragraph you are in luck. Command `git reflog`
enables you to *recall* detached local commits by referencing or applying them enables you to *recall* detached local commits by referencing or applying them
via commit-id. Although, do not expect to see really old commits in reflog, because via commit ID. Although, do not expect to see really old commits in reflog, because
Git regularly [cleans the commits which are *unreachable* by branches or tags](https://git-scm.com/book/en/v2/Git-Internals-Maintenance-and-Data-Recovery). Git regularly [cleans the commits which are *unreachable* by branches or tags](https://git-scm.com/book/en/v2/Git-Internals-Maintenance-and-Data-Recovery).
To view repository history and to track older commits you can use below command: To view repository history and to track older commits you can use below command:
...@@ -353,7 +353,7 @@ eb37e74 HEAD@{6}: rebase -i (pick): Commit C ...@@ -353,7 +353,7 @@ eb37e74 HEAD@{6}: rebase -i (pick): Commit C
6e43d59 HEAD@{16}: commit: Commit B 6e43d59 HEAD@{16}: commit: Commit B
``` ```
Output of command shows repository history. In first column there is commit-id, Output of command shows repository history. In first column there is commit ID,
in following column, number next to `HEAD` indicates how many commits ago something in following column, number next to `HEAD` indicates how many commits ago something
was made, after that indicator of action that was made (commit, rebase, merge, ...) was made, after that indicator of action that was made (commit, rebase, merge, ...)
and then on end description of that action. and then on end description of that action.
...@@ -393,7 +393,7 @@ passwords, SSH keys, etc. It is and should not be used to hide mistakes, as ...@@ -393,7 +393,7 @@ passwords, SSH keys, etc. It is and should not be used to hide mistakes, as
it will make it harder to debug in case there are some other bugs. The main it will make it harder to debug in case there are some other bugs. The main
reason for this is that you loose the real development progress. **Also keep in reason for this is that you loose the real development progress. **Also keep in
mind that, even with modified history, commits are just detached and can still be mind that, even with modified history, commits are just detached and can still be
accessed through commit-id** - at least until all repositories perform accessed through commit ID** - at least until all repositories perform
the cleanup of detached commits (happens automatically). the cleanup of detached commits (happens automatically).
![Modifying history causes problems on remote branch](img/rebase_reset.png) ![Modifying history causes problems on remote branch](img/rebase_reset.png)
...@@ -426,7 +426,7 @@ Never modify the commit history of `master` or shared branch. ...@@ -426,7 +426,7 @@ Never modify the commit history of `master` or shared branch.
After you know what you want to modify (how far in history or how which range of After you know what you want to modify (how far in history or how which range of
old commits), use `git rebase -i commit-id`. This command will then display all the commits from old commits), use `git rebase -i commit-id`. This command will then display all the commits from
current version to chosen commit-id and allow modification, squashing, deletion current version to chosen commit ID and allow modification, squashing, deletion
of that commits. of that commits.
```shell ```shell
......
...@@ -20,7 +20,7 @@ Branching in an Agile environment usually happens around user stories with one ...@@ -20,7 +20,7 @@ Branching in an Agile environment usually happens around user stories with one
or more developers working on it. or more developers working on it.
If more than one developer then another branch for each developer is also used If more than one developer then another branch for each developer is also used
with their initials, and US id. with their initials, and US ID.
After its tested merge into master and remove the branch. After its tested merge into master and remove the branch.
......
...@@ -418,7 +418,7 @@ the report JSON unless stated otherwise. Presence of optional fields depends on ...@@ -418,7 +418,7 @@ the report JSON unless stated otherwise. Presence of optional fields depends on
| `vulnerabilities[].confidence` | How reliable the vulnerability's assessment is. Possible values: `Ignore`, `Unknown`, `Experimental`, `Low`, `Medium`, `High`, `Confirmed`. **Note:** Our current container scanning tool based on [klar](https://github.com/optiopay/klar) does not provide a confidence level, so this value is currently hardcoded to `Unknown`. | | `vulnerabilities[].confidence` | How reliable the vulnerability's assessment is. Possible values: `Ignore`, `Unknown`, `Experimental`, `Low`, `Medium`, `High`, `Confirmed`. **Note:** Our current container scanning tool based on [klar](https://github.com/optiopay/klar) does not provide a confidence level, so this value is currently hardcoded to `Unknown`. |
| `vulnerabilities[].solution` | Explanation of how to fix the vulnerability. Optional. | | `vulnerabilities[].solution` | Explanation of how to fix the vulnerability. Optional. |
| `vulnerabilities[].scanner` | A node that describes the analyzer used to find this vulnerability. | | `vulnerabilities[].scanner` | A node that describes the analyzer used to find this vulnerability. |
| `vulnerabilities[].scanner.id` | Id of the scanner as a snake_case string. | | `vulnerabilities[].scanner.id` | ID of the scanner as a snake_case string. |
| `vulnerabilities[].scanner.name` | Name of the scanner, for display purposes. | | `vulnerabilities[].scanner.name` | Name of the scanner, for display purposes. |
| `vulnerabilities[].location` | A node that tells where the vulnerability is located. | | `vulnerabilities[].location` | A node that tells where the vulnerability is located. |
| `vulnerabilities[].location.dependency` | A node that describes the dependency of a project where the vulnerability is located. | | `vulnerabilities[].location.dependency` | A node that describes the dependency of a project where the vulnerability is located. |
...@@ -437,7 +437,7 @@ the report JSON unless stated otherwise. Presence of optional fields depends on ...@@ -437,7 +437,7 @@ the report JSON unless stated otherwise. Presence of optional fields depends on
| `vulnerabilities[].links[].url` | URL of the vulnerability details document. Optional. | | `vulnerabilities[].links[].url` | URL of the vulnerability details document. Optional. |
| `remediations` | An array of objects containing information on cured vulnerabilities along with patch diffs to apply. Empty if no remediations provided by an underlying analyzer. | | `remediations` | An array of objects containing information on cured vulnerabilities along with patch diffs to apply. Empty if no remediations provided by an underlying analyzer. |
| `remediations[].fixes` | An array of strings that represent references to vulnerabilities fixed by this particular remediation. | | `remediations[].fixes` | An array of strings that represent references to vulnerabilities fixed by this particular remediation. |
| `remediations[].fixes[].id` | The id of a fixed vulnerability. | | `remediations[].fixes[].id` | The ID of a fixed vulnerability. |
| `remediations[].fixes[].cve` | (**DEPRECATED - use `remediations[].fixes[].id` instead**) A string value that describes a fixed vulnerability in the same format as `vulnerabilities[].cve`. | | `remediations[].fixes[].cve` | (**DEPRECATED - use `remediations[].fixes[].id` instead**) A string value that describes a fixed vulnerability in the same format as `vulnerabilities[].cve`. |
| `remediations[].summary` | Overview of how the vulnerabilities have been fixed. | | `remediations[].summary` | Overview of how the vulnerabilities have been fixed. |
| `remediations[].diff` | base64-encoded remediation code diff, compatible with [`git apply`](https://git-scm.com/docs/git-format-patch#_discussion). | | `remediations[].diff` | base64-encoded remediation code diff, compatible with [`git apply`](https://git-scm.com/docs/git-format-patch#_discussion). |
......
...@@ -149,7 +149,7 @@ The [Security Scanner Integration](../../../development/integrations/secure.md) ...@@ -149,7 +149,7 @@ The [Security Scanner Integration](../../../development/integrations/secure.md)
| End line | ✓ | ✓ | 𐄂 | ✓ | ✓ | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | ✓ | | End line | ✓ | ✓ | 𐄂 | ✓ | ✓ | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | ✓ |
| Start column | ✓ | 𐄂 | 𐄂 | ✓ | ✓ | ✓ | ✓ | 𐄂 | 𐄂 | ✓ | ✓ | 𐄂 | ✓ | | Start column | ✓ | 𐄂 | 𐄂 | ✓ | ✓ | ✓ | ✓ | 𐄂 | 𐄂 | ✓ | ✓ | 𐄂 | ✓ |
| End column | ✓ | 𐄂 | 𐄂 | ✓ | ✓ | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | ✓ | | End column | ✓ | 𐄂 | 𐄂 | ✓ | ✓ | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | ✓ |
| External id (e.g. CVE) | 𐄂 | 𐄂 | ⚠ | 𐄂 | ⚠ | ✓ | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | | External ID (e.g. CVE) | 𐄂 | 𐄂 | ⚠ | 𐄂 | ⚠ | ✓ | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 |
| URLs | ✓ | 𐄂 | ✓ | 𐄂 | ⚠ | 𐄂 | ⚠ | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | | URLs | ✓ | 𐄂 | ✓ | 𐄂 | ⚠ | 𐄂 | ⚠ | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 |
| Internal doc/explanation | ✓ | ⚠ | ✓ | 𐄂 | ✓ | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | ✓ | 𐄂 | | Internal doc/explanation | ✓ | ⚠ | ✓ | 𐄂 | ✓ | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | ✓ | 𐄂 |
| Solution | ✓ | 𐄂 | 𐄂 | 𐄂 | ⚠ | ✓ | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | | Solution | ✓ | 𐄂 | 𐄂 | 𐄂 | ⚠ | ✓ | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 | 𐄂 |
......
...@@ -462,7 +462,7 @@ the report JSON unless stated otherwise. Presence of optional fields depends on ...@@ -462,7 +462,7 @@ the report JSON unless stated otherwise. Presence of optional fields depends on
| `vulnerabilities[].confidence` | How reliable the vulnerability's assessment is. Possible values: `Ignore`, `Unknown`, `Experimental`, `Low`, `Medium`, `High`, `Confirmed`. | | `vulnerabilities[].confidence` | How reliable the vulnerability's assessment is. Possible values: `Ignore`, `Unknown`, `Experimental`, `Low`, `Medium`, `High`, `Confirmed`. |
| `vulnerabilities[].solution` | Explanation of how to fix the vulnerability. Optional. | | `vulnerabilities[].solution` | Explanation of how to fix the vulnerability. Optional. |
| `vulnerabilities[].scanner` | A node that describes the analyzer used to find this vulnerability. | | `vulnerabilities[].scanner` | A node that describes the analyzer used to find this vulnerability. |
| `vulnerabilities[].scanner.id` | Id of the scanner as a snake_case string. | | `vulnerabilities[].scanner.id` | ID of the scanner as a snake_case string. |
| `vulnerabilities[].scanner.name` | Name of the scanner, for display purposes. | | `vulnerabilities[].scanner.name` | Name of the scanner, for display purposes. |
| `vulnerabilities[].location` | A node that tells where the vulnerability is located. | | `vulnerabilities[].location` | A node that tells where the vulnerability is located. |
| `vulnerabilities[].location.file` | Path to the file where the vulnerability is located. Optional. | | `vulnerabilities[].location.file` | Path to the file where the vulnerability is located. Optional. |
......
...@@ -673,7 +673,7 @@ The example below shows how to create a new package each time the `master` branc ...@@ -673,7 +673,7 @@ The example below shows how to create a new package each time the `master` branc
is updated: is updated:
1. Create a `ci_settings.xml` file that will serve as Maven's `settings.xml` file. 1. Create a `ci_settings.xml` file that will serve as Maven's `settings.xml` file.
Add the server section with the same id you defined in your `pom.xml` file. Add the server section with the same ID you defined in your `pom.xml` file.
For example, in our case it's `gitlab-maven`: For example, in our case it's `gitlab-maven`:
```xml ```xml
......
...@@ -201,7 +201,7 @@ nuget install <package_id> -OutputDirectory <output_directory> \ ...@@ -201,7 +201,7 @@ nuget install <package_id> -OutputDirectory <output_directory> \
Where: Where:
- `<package_id>` is the package id. - `<package_id>` is the package ID.
- `<output_directory>` is the output directory, where the package will be installed. - `<output_directory>` is the output directory, where the package will be installed.
- `<package_version>` (Optional) is the package version. - `<package_version>` (Optional) is the package version.
- `<source_name>` (Optional) is the source name. - `<source_name>` (Optional) is the source name.
...@@ -222,5 +222,5 @@ dotnet add package <package_id> \ ...@@ -222,5 +222,5 @@ dotnet add package <package_id> \
Where: Where:
- `<package_id>` is the package id. - `<package_id>` is the package ID.
- `<package_version>` (Optional) is the package version. - `<package_version>` (Optional) is the package version.
...@@ -225,7 +225,7 @@ Where: ...@@ -225,7 +225,7 @@ Where:
- `<package_name>` is the package name. - `<package_name>` is the package name.
- `<personal_access_token>` is a personal access token with the `read_api` scope. - `<personal_access_token>` is a personal access token with the `read_api` scope.
- `<project_id>` is the project id number. - `<project_id>` is the project ID.
If you were following the guide above and want to test installing the If you were following the guide above and want to test installing the
`MyPyPiPackage` package, you can run the following: `MyPyPiPackage` package, you can run the following:
......
...@@ -211,17 +211,17 @@ The following table lists all GitLab-specific email headers: ...@@ -211,17 +211,17 @@ The following table lists all GitLab-specific email headers:
| Header | Description | | Header | Description |
|------------------------------------|-------------------------------------------------------------------------| |------------------------------------|-------------------------------------------------------------------------|
| X-GitLab-Group-Id **(PREMIUM)** | The group's ID. Only present on notification emails for epics. | | `X-GitLab-Group-Id` **(PREMIUM)** | The group's ID. Only present on notification emails for epics. |
| X-GitLab-Group-Path **(PREMIUM)** | The group's path. Only present on notification emails for epics. | | `X-GitLab-Group-Path` **(PREMIUM)** | The group's path. Only present on notification emails for epics. |
| X-GitLab-Project | The name of the project the notification belongs to. | | `X-GitLab-Project` | The name of the project the notification belongs to. |
| X-GitLab-Project-Id | The project's ID. | | `X-GitLab-Project-Id` | The project's ID. |
| X-GitLab-Project-Path | The project's path. | | `X-GitLab-Project-Path` | The project's path. |
| X-GitLab-(Resource)-ID | The ID of the resource the notification is for. The resource, for example, can be `Issue`, `MergeRequest`, `Commit`, or another such resource. | | `X-GitLab-(Resource)-ID` | The ID of the resource the notification is for. The resource, for example, can be `Issue`, `MergeRequest`, `Commit`, or another such resource. |
| X-GitLab-Discussion-ID | The ID of the thread the comment belongs to, in notification emails for comments. | | `X-GitLab-Discussion-ID` | The ID of the thread the comment belongs to, in notification emails for comments. |
| X-GitLab-Pipeline-Id | The ID of the pipeline the notification is for, in notification emails for pipelines. | | `X-GitLab-Pipeline-Id` | The ID of the pipeline the notification is for, in notification emails for pipelines. |
| X-GitLab-Reply-Key | A unique token to support reply by email. | | `X-GitLab-Reply-Key` | A unique token to support reply by email. |
| X-GitLab-NotificationReason | The reason for the notification. This can be `mentioned`, `assigned`, or `own_activity`. | | `X-GitLab-NotificationReason` | The reason for the notification. This can be `mentioned`, `assigned`, or `own_activity`. |
| List-Id | The path of the project in an RFC 2919 mailing list identifier. This is useful for email organization with filters, for example. | | `List-Id` | The path of the project in an RFC 2919 mailing list identifier. This is useful for email organization with filters, for example. |
### X-GitLab-NotificationReason ### X-GitLab-NotificationReason
......
...@@ -1294,7 +1294,7 @@ X-Gitlab-Event: Job Hook ...@@ -1294,7 +1294,7 @@ X-Gitlab-Event: Job Hook
} }
``` ```
Note that `commit.id` is the id of the pipeline, not the id of the commit. Note that `commit.id` is the ID of the pipeline, not the ID of the commit.
## Image URL rewriting ## Image URL rewriting
......
...@@ -70,7 +70,7 @@ Data will be encoded with a comma as the column delimiter, with `"` used to quot ...@@ -70,7 +70,7 @@ Data will be encoded with a comma as the column delimiter, with `"` used to quot
| Labels | Title of any labels joined with a `,` | | Labels | Title of any labels joined with a `,` |
| Time Estimate | [Time estimate](../time_tracking.md#estimates) in seconds | | Time Estimate | [Time estimate](../time_tracking.md#estimates) in seconds |
| Time Spent | [Time spent](../time_tracking.md#time-spent) in seconds | | Time Spent | [Time spent](../time_tracking.md#time-spent) in seconds |
| Epic ID | Id of the parent epic **(ULTIMATE)**, introduced in 12.7 | | Epic ID | ID of the parent epic **(ULTIMATE)**, introduced in 12.7 |
| Epic Title | Title of the parent epic **(ULTIMATE)**, introduced in 12.7 | | Epic Title | Title of the parent epic **(ULTIMATE)**, introduced in 12.7 |
## Limitations ## Limitations
......
...@@ -53,7 +53,7 @@ From error list, users can navigate to the error details page by clicking the ti ...@@ -53,7 +53,7 @@ From error list, users can navigate to the error details page by clicking the ti
This page has: This page has:
- A link to the Sentry issue. - A link to the Sentry issue.
- A link to the GitLab commit if the Sentry [release id/version](https://docs.sentry.io/workflow/releases/?platform=javascript#configure-sdk) on the Sentry Issue's first release matches a commit SHA in your GitLab hosted project. - A link to the GitLab commit if the Sentry [release ID/version](https://docs.sentry.io/workflow/releases/?platform=javascript#configure-sdk) on the Sentry Issue's first release matches a commit SHA in your GitLab hosted project.
- Other details about the issue, including a full stack trace. - Other details about the issue, including a full stack trace.
- In [GitLab 12.7 and newer](https://gitlab.com/gitlab-org/gitlab/issues/36246), language and urgency are displayed. - In [GitLab 12.7 and newer](https://gitlab.com/gitlab-org/gitlab/issues/36246), language and urgency are displayed.
......
...@@ -273,7 +273,7 @@ func main() { ...@@ -273,7 +273,7 @@ func main() {
Here's an example of how to integrate the feature flags in a Ruby application. Here's an example of how to integrate the feature flags in a Ruby application.
The Unleash client is given a user id for use with a **Percent rollout (logged in users)** rollout strategy or a list of **Target Users**. The Unleash client is given a user ID for use with a **Percent rollout (logged in users)** rollout strategy or a list of **Target Users**.
```ruby ```ruby
#!/usr/bin/env ruby #!/usr/bin/env ruby
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment