diff options
Diffstat (limited to 'doc/development/routing.md')
-rw-r--r-- | doc/development/routing.md | 10 |
1 files changed, 8 insertions, 2 deletions
diff --git a/doc/development/routing.md b/doc/development/routing.md index 8f475674c39..78c540683ce 100644 --- a/doc/development/routing.md +++ b/doc/development/routing.md @@ -1,7 +1,7 @@ --- stage: none group: unassigned -info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments +info: Any user with at least the Maintainer role can merge updates to this content. For details, see https://docs.gitlab.com/ee/development/development_processes.html#development-guidelines-review. --- # Routing @@ -83,7 +83,8 @@ gitlab-org/serverless/runtimes/-/settings/repository Don't change a URL to an existing page, unless it's necessary. If you must make a change, make it unnoticeable for users, because we don't want them to receive `404 Not Found` -if we can avoid it. This table should help: +if we can avoid it. This table describes the minimum required in different +cases: | URL description | Example | What to do | |---|---|---| @@ -91,6 +92,11 @@ if we can avoid it. This table should help: | Likely to be saved or shared | `issue#show` | Add a redirect from an old URL to a new URL until the next major release. | | Limited use, unlikely to be shared | `admin#labels` | No extra steps required. | +In all cases, an old route should only be removed once traffic to it has +dropped sufficiently (e.g., according to logs or BigQuery). Otherwise, more +effort may be required to inform users about its deprecation before it can be +considered again for removal. + ## Migrating unscoped routes Currently, the majority of routes are placed under the `/-/` scope. However, |