Overview
This task ensures all moved documentation has Hugo aliases configured to automatically redirect from old URLs to new locations as described in SHIP-0041.
Description
Ensure all moved documentation has Hugo aliases configured to automatically redirect from old URLs to new locations. Test redirects work correctly in both local preview and production deployment.
Docusaurus configures redirects using a plugin configuration
{
redirects: [
{ from: ['/src/link/a', 'src/link/b'], to: '/target/link' },
]
}
Acceptance Criteria
Dependencies
- Blocks: Validate and fix all internal documentation links (Issue 11)
- Blocked by:
- Migrate existing content to Concepts section (Issue 4)
- Migrate existing content to How To section (Issue 5)
- Migrate and enhance Reference section (Issue 6)
- Migrate in-tree documentation from build repository (Issue 7)
- Migrate in-tree documentation from cli repository (Issue 8)
- Migrate in-tree documentation from operator repository (Issue 9)
Technical Notes
- Use the migration plan to identify all old paths that need aliases
- Configure aliases in the front matter of each migrated document
- Test redirects locally using
hugo server
- Verify redirects work in production (Netlify deployment)
- Check for redirect chains and optimize if needed
- Consider creating a script to automate alias configuration if there are many documents
Generated-by: Cursor
Overview
This task ensures all moved documentation has Hugo aliases configured to automatically redirect from old URLs to new locations as described in SHIP-0041.
Description
Ensure all moved documentation has Hugo aliases configured to automatically redirect from old URLs to new locations. Test redirects work correctly in both local preview and production deployment.
Docusaurus configures redirects using a plugin configuration
Acceptance Criteria
Dependencies
Technical Notes
hugo serverGenerated-by: Cursor