for users who view the docs on [`docs.gitlab.com`](https://docs.gitlab.com).
[`/help` on GitLab.com](https://gitlab.com/help). These must be added in the same
MR that renames or moves a doc. Redirects to internal pages expire after three months
and redirects to external pages (starting with `https:`) expire after a year.
-[GitLab Pages redirects](../../user/project/pages/redirects.md), which are added
automatically after redirect files expire. They must not be manually added by
contributors and expire after nine months. Redirects pointing to external sites
are not added to the GitLab Pages redirects.
The Technical Writing team manages the [process](https://gitlab.com/gitlab-org/technical-writing/-/blob/main/.gitlab/issue_templates/tw-monthly-tasks.md)
to regularly update and [clean up the redirects](https://gitlab.com/gitlab-org/gitlab-docs/-/blob/main/doc/raketasks.md#clean-up-redirects).
If you're a contributor, you may add a new redirect, but you don't need to delete
the old ones. This process is automatic and handled by the Technical
Writing team.
Expired redirect files are removed from the documentation projects by the
as part of the Technical Writing team's [monthly tasks](https://gitlab.com/gitlab-org/technical-writing/-/blob/main/.gitlab/issue_templates/tw-monthly-tasks.md).
## Add a redirect
NOTE:
If the old page you're renaming doesn't exist in a stable branch, skip the
following steps and ask a Technical Writer to add the redirect in
If the renamed page is new, you can sometimes skip the following steps and ask a
Technical Writer to manually add the redirect to [`redirects.yaml`](https://gitlab.com/gitlab-org/gitlab-docs/-/blob/main/content/_data/redirects.yaml).
For example, if you add a new page and then rename it before it's added to a release
on the 18th. The old page is not in any version's `/help` section, so a technical writer
can jump straight to the [Pages redirect](https://gitlab.com/gitlab-org/gitlab-docs/-/blob/main/doc/maintenance.md#pages-redirects).