Skip to content

Fix redirected URLs in docs sitemap - #808

Merged
danstotts-ops merged 1 commit into
mainfrom
agent/fix-docs-redirect-sitemap
Aug 19, 2026
Merged

Fix redirected URLs in docs sitemap#808
danstotts-ops merged 1 commit into
mainfrom
agent/fix-docs-redirect-sitemap

Conversation

@danstotts-ops

Copy link
Copy Markdown
Contributor

What changed

  • Delete 24 legacy MDX files whose routes are already covered by permanent redirects in docs.json.
  • Add scripts/validate-redirect-sources.js to prevent redirect source files from being emitted by Mintlify's generated sitemap.
  • Run the new validation in the existing required docs validation workflow.

Why

Google Search Console reports 24 submitted pages under "Page with redirect." All 24 are present in https://docs.runpod.io/sitemap.xml, all resolve through a single permanent redirect to a 200 destination, and all correspond to source files that overlap existing redirect rules.

Removing the obsolete source files keeps the redirects for backlinks and bookmarks while allowing Mintlify to remove those source URLs from its generated sitemap. It preserves seo.indexing: "all" and leaves other intentionally indexed hidden pages unchanged.

Validation

  • node scripts/validate-redirect-sources.js, 293 redirects checked, zero source-file collisions
  • node scripts/validate-tooltips.js, pass with four pre-existing unused-import warnings
  • python3 -m json.tool docs.json, pass
  • git diff --check, pass
  • npx --yes mintlify@latest broken-links, reports the five pre-existing broken links in CLAUDE.md and instant-clusters/ray-vllm.mdx; none reference the 24 removed routes

Expected impact

After merge and Mintlify deployment, the generated docs sitemap should drop the 24 redirecting URLs. The permanent redirects remain available for legacy inbound traffic. GSC validation should wait until the live sitemap confirms the URLs are gone.

@mintlify

mintlify Bot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
runpod-docs 🟢 Ready View Preview Aug 19, 2026, 10:33 PM

Copy link
Copy Markdown
Contributor Author

Preview verification, 2026-08-19 16:34 MDT:

  • sitemap.xml contains 334 URLs, down from 358 on production.
  • All 24 GSC-submitted redirect source URLs are absent from the preview sitemap.
  • Representative legacy paths still redirect in one hop to their intended 200 destinations: network volumes, account management, Python handler functions, and SDK endpoints.

Preview: https://runpod-b18f5ded-agent-fix-docs-redirect-sitemap.mintlify.site

@danstotts-ops
danstotts-ops marked this pull request as ready for review August 19, 2026 22:40
@danstotts-ops
danstotts-ops merged commit e1baaf1 into main Aug 19, 2026
4 checks passed
@danstotts-ops
danstotts-ops deleted the agent/fix-docs-redirect-sitemap branch August 19, 2026 23:04
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.

2 participants