Move incident-management directory to infrastructure-platforms

Nick Nguyenrequested to merge
move-incident-management-to-infrastructure-platforms into main

Summary

As part of gitlab-com/gl-infra/mstaff#453, this MR moves the incident-management directory from content/handbook/engineering/infrastructure/incident-management to content/handbook/engineering/infrastructure-platforms/incident-management.

Changes Made

Files Moved

  • All files and subdirectories from content/handbook/engineering/infrastructure/incident-management/ to content/handbook/engineering/infrastructure-platforms/incident-management/
    • _index.md
    • incident-follow-ups.md
    • incident-manager-onboarding.md
    • tier2-escalations.md
    • on-call/ directory (5 files)
    • roles/ directory (3 files)

Updated Files

  • .gitlab/CODEOWNERS: Updated path from /content/handbook/engineering/infrastructure/incident-management/ to /content/handbook/engineering/infrastructure-platforms/incident-management/
  • layouts/index.redirects: Added redirect entries to ensure all old links continue to work

Redirects Added 

# Incident Management moved to infrastructure-platforms - remove 2026-02-26
/handbook/engineering/infrastructure/incident-management/ /handbook/engineering/infrastructure-platforms/incident-management/ 301


/handbook/engineering/infrastructure/incident-management/* /handbook/engineering/infrastructure-platforms/incident-management/:splat 301

Links That Need Updating

The redirects ensure backward compatibility, but the following files contain links that reference the old path. These links will continue to work via redirects, but should be updated in a follow-up MR for cleanliness:

Note: There are approximately 100+ references across the handbook that should be updated from /handbook/engineering/infrastructure/incident-management/ to /handbook/engineering/infrastructure-platforms/incident-management/. The redirects ensure these will continue to work.

Key files with multiple references include:

  • Engineering documentation
  • Support workflows
  • Job families
  • Security documentation
  • Product development guides

Testing

  • Files successfully moved to new location
  • CODEOWNERS updated
  • Redirects added to layouts/index.redirects
  • Verify redirects work after deployment

Edited by Nick Nguyen

Merge request reports