diff --git a/doc/administration/auth/ldap/index.md b/doc/administration/auth/ldap/index.md index 3bb9350e960ff4167982b885d86a842b2f49308d..6243f3da2d20aa30cb5c440f1a9ceec992ff19b8 100644 --- a/doc/administration/auth/ldap/index.md +++ b/doc/administration/auth/ldap/index.md @@ -179,7 +179,7 @@ These configuration settings are available: | `allow_username_or_email_login` | If enabled, GitLab ignores everything after the first `@` in the LDAP username submitted by the user on sign-in. If you are using `uid: 'userPrincipalName'` on ActiveDirectory you must disable this setting, because the userPrincipalName contains an `@`. | **{dotted-circle}** No | boolean | | `block_auto_created_users` | To maintain tight control over the number of billable users on your GitLab installation, enable this setting to keep new users blocked until they have been cleared by an administrator (default: false). | **{dotted-circle}** No | boolean | | `base` | Base where we can search for users. | **{check-circle}** Yes | `'ou=people,dc=gitlab,dc=example'` or `'DC=mydomain,DC=com'` | -| `user_filter` | Filter LDAP users. Format: [RFC 4515](https://tools.ietf.org/search/rfc4515) Note: GitLab does not support `omniauth-ldap`'s custom filter syntax. | **{dotted-circle}** No | For examples, read [Examples of user filters](#examples-of-user-filters). | +| `user_filter` | Filter LDAP users. Format: [RFC 4515](https://www.rfc-editor.org/rfc/rfc4515.html) Note: GitLab does not support `omniauth-ldap`'s custom filter syntax. | **{dotted-circle}** No | For examples, read [Examples of user filters](#examples-of-user-filters). | | `lowercase_usernames` | If enabled, GitLab converts the name to lower case. | **{dotted-circle}** No | boolean | | `retry_empty_result_with_codes` | An array of LDAP query response code that attempt to retry the operation if the result/content is empty. For Google Secure LDAP, set this value to `[80]`. | **{dotted-circle}** No | `[80]` | @@ -281,7 +281,7 @@ This example results in a sign-in page with the following tabs: To limit all GitLab access to a subset of the LDAP users on your LDAP server, first narrow the configured `base`. However, to further filter users if -necessary, you can set up an LDAP user filter. The filter must comply with [RFC 4515](https://tools.ietf.org/search/rfc4515). +necessary, you can set up an LDAP user filter. The filter must comply with [RFC 4515](https://www.rfc-editor.org/rfc/rfc4515.html). - Example user filter for Omnibus GitLab instances: @@ -336,7 +336,7 @@ The `user_filter` DN can contain special characters. For example: ``` These characters must be escaped as documented in - [RFC 4515](https://tools.ietf.org/search/rfc4515). + [RFC 4515](https://www.rfc-editor.org/rfc/rfc4515.html). - Escape commas with `\2C`. For example: diff --git a/doc/administration/consul.md b/doc/administration/consul.md index f9e4e7d6d4401a8427bcdd5200cc58cde0d5cb69..965231db4405ce5b6c9d90644251c48d977829a5 100644 --- a/doc/administration/consul.md +++ b/doc/administration/consul.md @@ -8,7 +8,7 @@ type: reference # How to set up Consul **(PREMIUM SELF)** A Consul cluster consists of both -[server and client agents](https://www.consul.io/docs/agent). +[server and client agents](https://developer.hashicorp.com/consul/docs/agent). The servers run on their own nodes and the clients run on other nodes that in turn communicate with the servers. @@ -99,7 +99,7 @@ Consul nodes communicate using the raft protocol. If the current leader goes offline, there must be a leader election. A leader node must exist to facilitate synchronization across the cluster. If too many nodes go offline at the same time, the cluster loses quorum and doesn't elect a leader due to -[broken consensus](https://www.consul.io/docs/architecture/consensus). +[broken consensus](https://developer.hashicorp.com/consul/docs/architecture/consensus). Consult the [troubleshooting section](#troubleshooting-consul) if the cluster is not able to recover after the upgrade. The [outage recovery](#outage-recovery) may @@ -148,7 +148,7 @@ you follow the Consul [outage recovery](#outage-recovery) process. To be safe, it's recommended that you only restart Consul in one node at a time to ensure the cluster remains intact. For larger clusters, it is possible to restart multiple nodes at a time. See the -[Consul consensus document](https://www.consul.io/docs/architecture/consensus#deployment-table) +[Consul consensus document](https://developer.hashicorp.com/consul/docs/architecture/consensus#deployment-table) for the number of failures it can tolerate. This is the number of simultaneous restarts it can sustain. @@ -161,7 +161,7 @@ sudo gitlab-ctl restart consul ### Consul nodes unable to communicate By default, Consul attempts to -[bind](https://www.consul.io/docs/agent/config/config-files#bind_addr) to `0.0.0.0`, but +[bind](https://developer.hashicorp.com/consul/docs/agent/config/config-files#bind_addr) to `0.0.0.0`, but it advertises the first private IP address on the node for other Consul nodes to communicate with it. If the other nodes cannot communicate with a node on this address, then the cluster has a failed status. diff --git a/doc/administration/monitoring/performance/grafana_configuration.md b/doc/administration/monitoring/performance/grafana_configuration.md index 49f92572cc545c26bc8e3f53ba59954bb541a007..92e9672cdb6fd2e02bed3f02b4f6e6becfc8836a 100644 --- a/doc/administration/monitoring/performance/grafana_configuration.md +++ b/doc/administration/monitoring/performance/grafana_configuration.md @@ -133,8 +133,8 @@ However, you should **not** reinstate your old data _except_ under one of the fo If you require access to your old Grafana data but don't meet one of these criteria, you may consider: 1. Reinstating it temporarily. -1. [Exporting the dashboards](https://grafana.com/docs/grafana/latest/dashboards/export-import/#exporting-a-dashboard) you need. -1. Refreshing the data and [re-importing your dashboards](https://grafana.com/docs/grafana/latest/dashboards/export-import/#import-dashboard). +1. [Exporting the dashboards](https://grafana.com/docs/grafana/latest/dashboards/manage-dashboards/#export-and-import-dashboards) you need. +1. Refreshing the data and [re-importing your dashboards](https://grafana.com/docs/grafana/latest/dashboards/manage-dashboards/#export-and-import-dashboards). WARNING: These actions pose a temporary vulnerability while your old Grafana data is in use. diff --git a/doc/administration/package_information/defaults.md b/doc/administration/package_information/defaults.md index 381f35d7c1252b6691bfe3f0f121cc936f562117..717e5ca31c98d59200ccef67f6abd6cfefc07c21 100644 --- a/doc/administration/package_information/defaults.md +++ b/doc/administration/package_information/defaults.md @@ -70,6 +70,6 @@ over a network which will require, based on implementation, ports `111` and NOTE: In some cases, the GitLab Registry will be automatically enabled by default. See [our documentation](../packages/container_registry.md) for more details. - [^Consul-notes]: If using additional Consul functionality, more ports may need to be opened. See the [official documentation](https://www.consul.io/docs/install/ports#ports-table) for the list. + [^Consul-notes]: If using additional Consul functionality, more ports may need to be opened. See the [official documentation](https://developer.hashicorp.com/consul/docs/install/ports#ports-table) for the list. [^Sidekiq-health]: If Sidekiq health check settings are not set, they will default to the Sidekiq metrics exporter settings. This default is deprecated and is set to be removed in [GitLab 15.0](https://gitlab.com/gitlab-org/gitlab/-/issues/347509). diff --git a/doc/api/index.md b/doc/api/index.md index 7e14137b0fed41a0f5ff8a2d079e023fc5580f33..cc54731de81bc1775c9bbd7819268612ef5061fd 100644 --- a/doc/api/index.md +++ b/doc/api/index.md @@ -593,7 +593,7 @@ GET /api/v4/projects/1/repository/tags/my%2Ftag ## Request Payload API Requests can use parameters sent as [query strings](https://en.wikipedia.org/wiki/Query_string) -or as a [payload body](https://tools.ietf.org/html/draft-ietf-httpbis-p3-payload-14#section-3.2). +or as a [payload body](https://datatracker.ietf.org/doc/html/draft-ietf-httpbis-p3-payload-14#section-3.2). GET requests usually send a query string, while PUT or POST requests usually send the payload body: diff --git a/doc/api/oauth2.md b/doc/api/oauth2.md index aca6ee74b158f18f6e9a521441e9b17354deb67f..371e3f9ae474aef53b27c91150b0184d3b335348 100644 --- a/doc/api/oauth2.md +++ b/doc/api/oauth2.md @@ -63,7 +63,7 @@ For a list of scopes in GitLab, see [the provider documentation](../integration/ ### Prevent CSRF attacks -To [protect redirect-based flows](https://tools.ietf.org/id/draft-ietf-oauth-security-topics-13.html#rec_redirect), +To [protect redirect-based flows](https://datatracker.ietf.org/doc/html/draft-ietf-oauth-security-topics-13#section-3.1), the OAuth specification recommends the use of "One-time use CSRF tokens carried in the state parameter, which are securely bound to the user agent", with each request to the `/oauth/authorize` endpoint. This can prevent diff --git a/doc/ci/testing/load_performance_testing.md b/doc/ci/testing/load_performance_testing.md index 6e1b440f252b1b0682376883e4d83f283ecbc8e2..ba7bf14fb590e6df402f2cd8ed005a28387146c9 100644 --- a/doc/ci/testing/load_performance_testing.md +++ b/doc/ci/testing/load_performance_testing.md @@ -138,7 +138,7 @@ For example, you can override the duration of the test with a CLI option: ``` GitLab only displays the key performance metrics in the MR widget if k6's results are saved -via [summary export](https://k6.io/docs/results-visualization/json#summary-export) +via [summary export](https://k6.io/docs/results-output/real-time/json/#summary-export) as a [Load Performance report artifact](../yaml/artifacts_reports.md#artifactsreportsload_performance). The latest Load Performance artifact available is always used, using the summary values from the test. diff --git a/doc/development/fe_guide/style/scss.md b/doc/development/fe_guide/style/scss.md index aacf07fda9280649ac4d75b3a5e6daa809229f05..98f74813231ff362503ed2a24d5193a08e99c58e 100644 --- a/doc/development/fe_guide/style/scss.md +++ b/doc/development/fe_guide/style/scss.md @@ -176,7 +176,7 @@ To check if any warnings are produced by your changes, run `yarn lint:stylelint` catch any warnings. If the Rake task is throwing warnings you don't understand, SCSS Lint's -documentation includes [a full list of their rules](https://stylelint.io/user-guide/rules/list/). +documentation includes [a full list of their rules](https://stylelint.io/user-guide/rules/). ### Fixing issues diff --git a/doc/development/feature_flags/controls.md b/doc/development/feature_flags/controls.md index e6c3c20d50b5cef0330b852372d7e866e3cd22e7..e804a888e981d71f3af2f0ef8f8c88957f617996 100644 --- a/doc/development/feature_flags/controls.md +++ b/doc/development/feature_flags/controls.md @@ -16,7 +16,7 @@ To turn on/off features behind feature flags in any of the GitLab-provided environments, like staging and production, you need to have access to the [ChatOps](../chatops_on_gitlabcom.md) bot. The ChatOps bot is currently running on the ops instance, which is different from -[GitLab.com](https://gitlab.com) or [`dev.gitlab.org`](https://dev.gitlab.org). +[GitLab.com](https://gitlab.com) or `dev.gitlab.org`. Follow the ChatOps document to [request access](../chatops_on_gitlabcom.md#requesting-access). @@ -55,8 +55,8 @@ change feature flags or you do not have access. ### Enabling a feature for pre-production testing As a first step in a feature rollout, you should enable the feature on -[`staging.gitlab.com`](https://staging.gitlab.com) -and [`dev.gitlab.org`](https://dev.gitlab.org). +`staging.gitlab.com` +and `dev.gitlab.org`. These two environments have different scopes. `dev.gitlab.org` is a production CE environment that has internal GitLab Inc. diff --git a/doc/development/feature_flags/index.md b/doc/development/feature_flags/index.md index f1cde4ae1ea510a1f398bec596ae417d8c35f8aa..500afa8ba1de9ba5f1c6dc8611975e3d1d3e3a18 100644 --- a/doc/development/feature_flags/index.md +++ b/doc/development/feature_flags/index.md @@ -435,7 +435,7 @@ For example, the following feature flags are enabled for a certain percentage of If a project A has `:feature-set-1` enabled, there is no guarantee that project A also has `:feature-set-2` enabled. -For more detail, see [This is how percentages work in Flipper](https://www.hackwithpassion.com/this-is-how-percentages-work-in-flipper). +For more detail, see [This is how percentages work in Flipper](https://www.hackwithpassion.com/this-is-how-percentages-work-in-flipper/). #### Use actors for verifying in production diff --git a/doc/development/secure_coding_guidelines.md b/doc/development/secure_coding_guidelines.md index 7b787b67bcaaf524e1cb93370afe81434bd0bc0a..c102e99720fd85dacc6804d7147aeb9513605759 100644 --- a/doc/development/secure_coding_guidelines.md +++ b/doc/development/secure_coding_guidelines.md @@ -856,7 +856,7 @@ Working with archive files like `zip`, `tar`, `jar`, `war`, `cpio`, `apk`, `rar` ### Zip Slip -In 2018, the security company Snyk [released a blog post](https://snyk.io/research/zip-slip-vulnerability) describing research into a widespread and critical vulnerability present in many libraries and applications which allows an attacker to overwrite arbitrary files on the server file system which, in many cases, can be leveraged to achieve remote code execution. The vulnerability was dubbed Zip Slip. +In 2018, the security company Snyk [released a blog post](https://security.snyk.io/research/zip-slip-vulnerability) describing research into a widespread and critical vulnerability present in many libraries and applications which allows an attacker to overwrite arbitrary files on the server file system which, in many cases, can be leveraged to achieve remote code execution. The vulnerability was dubbed Zip Slip. A Zip Slip vulnerability happens when an application extracts an archive without validating and sanitizing the filenames inside the archive for directory traversal sequences that change the file location when the file is extracted. diff --git a/doc/development/service_ping/implement.md b/doc/development/service_ping/implement.md index 48992256ae413f712ff81045f9f88a1b4a9fc81b..896db6671535851c81126104fcafa3b6fcbcea81 100644 --- a/doc/development/service_ping/implement.md +++ b/doc/development/service_ping/implement.md @@ -266,7 +266,7 @@ Arguments: #### Ordinary Redis counters -Example of implementation: [`Gitlab::UsageDataCounters::WikiPageCounter`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/usage_data_counters/wiki_page_counter.rb), using Redis methods [`INCR`](https://redis.io/commands/incr) and [`GET`](https://redis.io/commands/get). +Example of implementation: [`Gitlab::UsageDataCounters::WikiPageCounter`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/usage_data_counters/wiki_page_counter.rb), using Redis methods [`INCR`](https://redis.io/commands/incr/) and [`GET`](https://redis.io/commands/get/). Events are handled by counter classes in the `Gitlab::UsageDataCounters` namespace, inheriting from `BaseCounter`, that are either: diff --git a/doc/development/snowplow/index.md b/doc/development/snowplow/index.md index 7dec2740da217e441577abf03267170bc6285c8c..8d05e05e5920ecd67ad5f814a59df5fa1b733da2 100644 --- a/doc/development/snowplow/index.md +++ b/doc/development/snowplow/index.md @@ -186,7 +186,7 @@ LIMIT 100 ### Web-specific parameters -Snowplow JavaScript adds [web-specific parameters](https://docs.snowplowanalytics.com/docs/collecting-data/collecting-from-own-applications/snowplow-tracker-protocol/#Web-specific_parameters) to all web events by default. +Snowplow JavaScript adds [web-specific parameters](https://docs.snowplow.io/docs/collecting-data/collecting-from-own-applications/snowplow-tracker-protocol/#Web-specific_parameters) to all web events by default. ## Related topics diff --git a/doc/development/stage_group_observability/dashboards/index.md b/doc/development/stage_group_observability/dashboards/index.md index 9f9ba609271a19afce98139bca6b018e065a0e95..c2da46bde7d2a9e6690b015d54e5a3af52b1fbcf 100644 --- a/doc/development/stage_group_observability/dashboards/index.md +++ b/doc/development/stage_group_observability/dashboards/index.md @@ -43,7 +43,7 @@ All metrics recorded in the GitLab production system have [one-year retention](https://gitlab.com/gitlab-cookbooks/gitlab-prometheus/-/blob/31526b03fef823e2f9b3cda7c75dcd28a12418a3/attributes/prometheus.rb#L40). You can also zoom in and filter the time range directly on a graph. For more information, see the -[Grafana Time Range Controls](https://grafana.com/docs/grafana/latest/dashboards/time-range-controls/) +[Grafana Time Range Controls](https://grafana.com/docs/grafana/latest/dashboards/use-dashboards/#set-dashboard-time-range) documentation. ## Filters and annotations @@ -51,7 +51,7 @@ documentation. On each dashboard, there are two filters and some annotation switches on the top of the page. Some special events are meaningful to development and operational activities. -[Grafana annotations](https://grafana.com/docs/grafana/latest/dashboards/annotations/) mark them +[Grafana annotations](https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/annotate-visualizations/) mark them directly on the graphs.  diff --git a/doc/integration/gitpod.md b/doc/integration/gitpod.md index 26d0da4b49dc11ec8b266e81ea2c46ed363c6542..0088d4b886d8a83270cbda065b6eea36d8e815d2 100644 --- a/doc/integration/gitpod.md +++ b/doc/integration/gitpod.md @@ -44,7 +44,7 @@ With the Gitpod integration enabled for your GitLab instance, to enable it for y For GitLab self-managed instances, a GitLab administrator needs to: -1. Set up a Gitpod instance to integrate with GitLab. Refer to the [Gitpod documentation](https://www.gitpod.io/docs/self-hosted/latest) +1. Set up a Gitpod instance to integrate with GitLab. Refer to the [Gitpod documentation](https://www.gitpod.io/docs/configure/self-hosted/latest) to get your instance up and running. 1. Enable it in GitLab: 1. On the top bar, select **Main menu > Admin**. diff --git a/doc/user/infrastructure/iac/terraform_state.md b/doc/user/infrastructure/iac/terraform_state.md index 9cb3fdd7aaf6614d09e0b591b34770ba2703b84d..a690cc781213a0799126a686da9da6a79b05c51f 100644 --- a/doc/user/infrastructure/iac/terraform_state.md +++ b/doc/user/infrastructure/iac/terraform_state.md @@ -59,7 +59,7 @@ encrypt plan output or modify the project visibility settings. To configure GitLab CI/CD as a backend: 1. In your Terraform project, in a `.tf` file like `backend.tf`, - define the [HTTP backend](https://www.terraform.io/docs/language/settings/backends/http.html): + define the [HTTP backend](https://developer.hashicorp.com/terraform/language/settings/backends/http): ```hcl terraform { diff --git a/doc/user/project/import/clearcase.md b/doc/user/project/import/clearcase.md index 1dc62cbbe3599730762b6e9468799b46292766fc..0878476d59f9da75e2fddb0ad06a699190bfda47 100644 --- a/doc/user/project/import/clearcase.md +++ b/doc/user/project/import/clearcase.md @@ -27,7 +27,7 @@ The following table illustrates the main differences between ClearCase and Git: | Server | UNIX, Windows legacy systems | UNIX, macOS | | License | Proprietary | GPL | -_Taken from the slides [ClearCase and the journey to Git](https://docplayer.net/42708453-Clearcase-the-journey-to-git-migrating-your-skills-and-vobs-to-git.html) provided by [collab.net](https://www.collab.net/)_ +_Taken from the slides [ClearCase and the journey to Git](https://docplayer.net/42708453-Clearcase-the-journey-to-git-migrating-your-skills-and-vobs-to-git.html) provided by `collab.net`_ ## Why migrate diff --git a/doc/user/project/pages/public_folder.md b/doc/user/project/pages/public_folder.md index b5d498402d5b521a6029a2f5e6e56782fae76450..a19e296b9547e5614660c3cc7df2c35b2d2e8a14 100644 --- a/doc/user/project/pages/public_folder.md +++ b/doc/user/project/pages/public_folder.md @@ -116,7 +116,7 @@ GitLab Pages supports only static sites. ``` 1. Configure your Nuxt.js application for - [Static Site Generation](https://nuxtjs.org/docs/features/deployment-targets#static-hosting). + [Static Site Generation](https://nuxtjs.org/docs/features/deployment-targets/#static-hosting). ### Vite