Skip to content

Conversation

@lgecse
Copy link
Member

@lgecse lgecse commented Nov 14, 2025

Fixes #310

Add mkdocs-redirects plugin and contribution guidelines

Changes

  • Added mkdocs-redirects plugin: Installed and configured mkdocs-redirects>=1.2.0 to handle URL redirects for moved documentation pages
  • Configured redirects: Added redirect mappings for three moved pages:
    • how-to-guides/identity-quickstart/identity/identity-quickstart/
    • how-to-guides/agent-directory/dir/getting-started/
  • Updated contributing guide: Added a new section on moving/renaming documentation files that requires contributors to add redirects when moving content

Why

This ensures that external links, bookmarks, and search engine results continue to work when documentation is reorganized, providing a better user experience and maintaining SEO value.

Testing

  • Docs build successfully with task build
  • Redirect HTML pages generated correctly in build output
  • Both redirects tested and working

@lgecse lgecse requested a review from a team as a code owner November 14, 2025 09:11
@lgecse lgecse requested review from keraron and muscariello and removed request for a team November 14, 2025 09:11
@lgecse lgecse changed the title feat: add redirect plugin and first config of know moved content feat: add redirect plugin and first config of known moved content Nov 14, 2025
@lgecse lgecse merged commit 02867cf into main Nov 14, 2025
5 checks passed
@lgecse lgecse deleted the redirect branch November 14, 2025 09:53
jchatfranklin pushed a commit to jchatfranklin/docs that referenced this pull request Nov 18, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Docs]: create placeholder links for moved content

3 participants