Update URL path to match page names
Problem to solve
Over the years, pages in GitLab have undergone name changes but those changes have not been reflected in the url structure.
The deprecation is the removal of these redirects. We can add them without a deprecation notice
We do not need to announce the deprecation until the 301 redirects are removed. The foundations team will handle this deprecation in a future major release.
Proposal
In order to match the user's expectations with our new navigation, we will use 301 redirects to change the URLs to match their representative page names. We are making this change for consistency. The site will function correctly, and this is not a breaking change.
- Deliver the changes with re-directs in place.
- Aug 9 -
- Removed /-/tree/{default branch name to /-/repository/{default branch name} from this proposal, it is too risky
- Added issue for removing the 301 redirects is a breaking change issue for the breaking change planned for 17.0
- Notify users via a blog post
Project items
| Old Sidebar | New Nav | Path | Replacement | DRI |
|---|---|---|---|---|
| Repository / Contributor statistics | Analyze / Contributor statistics | /-/graphs/{default branch name} | /-/contributor_statistics/{default branch name} | @derekferguson |
| Repository / Graph | Code / Repository graph | /-/network/{default branch name} | /-/repository_graph/{default branch name} | @derekferguson |
| Repository / Locked files | Code / Locked files | /path_locks | /-/locked_files | @derekferguson |
| Monitoring / Alerts | Monitor / Alerts | /-/alert_management | /-/alerts | |
| Settings / Webhooks | Settings / Webhooks | /-/hooks | /-/settings/webhooks - note this is an opportunity to rename the controller too #390591 (comment 1373466129) | @m_frankiewicz |
| Settings / Monitor | Settings / Monitor | /-/settings/operations | /-/settings/monitor |
User Settings
All the user settings pages use /profile as the root
| Sidebar | Path | Additon | DRI |
|---|---|---|---|
| User settings ↳ Profile |
/-/profile | /-/user_settings/profile | @lohrc |
| User settings ↳ Account |
/-/profile/account | /-/user_settings/account | |
| User settings ↳ Applications |
/-/profile/applications | /-/user_settings/applications | @hsutor |
| User settings ↳ Chat |
/-/profile/chat_names | /-/user_settings/chat | @m_frankiewicz |
| User settings ↳ Personal access tokens |
/-/profile/personal_access_tokens | /-/user_settings/personal_access_tokens | @hsutor |
| User settings ↳ Emails |
/-/profile/emails | /-/user_settings/emails | |
| User settings ↳ Password |
/-/profile/password/edit | /-/user_settings/password/edit | @hsutor |
| User settings ↳ Notifications |
/-/profile/notifications | /-/user_settings/notifications | |
| User settings ↳ SSH Keys |
/-/profile/keys | /-/user_settings/ssh_keys | @hsutor |
| User settings ↳ GPG Keys |
/-/profile/gpg_keys | /-/user_settings/gpg_keys | @hsutor |
| User settings ↳ Preferences |
/-/profile/preferences | /-/user_settings/preferences | |
| User settings ↳ Active Sessions |
/-/profile/active_sessions | /-/user_settings/active_sessions | @hsutor |
| User settings ↳ Authentication Log |
/-/profile/audit_log | /-/user_settings/authentication_log | @hsutor |
| User settings ↳ Usage Qutoas |
/-/profile/usage_quotas | /-/user_settings/usage_quotas | @alex_martin |
Edited by Sam Beckham