Skip to content

feat: add redirect plugin and first config of known moved content - #316

Merged
lgecse merged 1 commit into
mainfrom
redirect
Nov 14, 2025
Merged

feat: add redirect plugin and first config of known moved content#316
lgecse merged 1 commit into
mainfrom
redirect

Conversation

@lgecse

@lgecse lgecse commented Nov 14, 2025

Copy link
Copy Markdown
Member

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

Signed-off-by: Laszlo Gecse <lgecse@cisco.com>
@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
…tcy#316)

Signed-off-by: Laszlo Gecse <lgecse@cisco.com>
Signed-off-by: jchatfranklin <jerryfranklin@gmail.com>
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

2 participants