Skip to content

Add missing doc redirects and a CI check for them - #11794

Open
headtr1ck wants to merge 5 commits into
pydata:mainfrom
headtr1ck:docs-missing-redirects
Open

headtr1ck wants to merge 5 commits into
pydata:mainfrom
headtr1ck:docs-missing-redirects

Conversation

@headtr1ck

@headtr1ck headtr1ck commented Oct 23, 2026 •

Copy link
Copy Markdown
Collaborator

Description

Several doc pages were moved or removed without a redirect, so their old URLs 404 (e.g. the Tutorials link on xarray.dev). This adds the missing redirects and a CI check so it doesn't happen again:

  • Redirects for the five pages moved in Switch documentation to pydata-sphinx-theme #8708 that still had none (tutorials-and-videos, help-diagram, howdoi, ecosystem, getting-started-guide/faq) and for older moved pages (quickstart, why-xray, whats_new, examples, internals, ...)
  • New check-doc-redirects job in CI Additional: every page ever added to doc/ must still exist or be in rediraffe_redirects. Pages removed on purpose without a successor are listed in the check.

Checklist

AI Disclosure

  • This PR contains AI-generated content.
    • I have tested any AI-generated content in my PR.
    • I take responsibility for any AI-generated content in my PR.
      Tools: Claude Code

🤖 Generated with Claude Code

headtr1ck and others added 3 commits October 23, 2026 08:07
Closes pydata#11790

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Every page ever added to doc/ must still exist or have a redirect in rediraffe_redirects. Pages removed on purpose without a successor are listed in the check.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions github-actions Bot added the Automation Github bots, testing workflows, release automation label Oct 23, 2026
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@headtr1ck headtr1ck changed the title Add redirects for doc pages moved without one Add missing doc redirects and a CI check for them Oct 23, 2026
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@headtr1ck headtr1ck added the plan to merge Final call for comments label Oct 23, 2026
@keewis

keewis commented Oct 23, 2026 •

Copy link
Copy Markdown
Collaborator

FYI while this will help with the docs (and any old bookmarks or any links we don't control), this won't be a proper fix for the referenced issue: we should modify that link in xarray-contrib/xarray.dev instead

@headtr1ck

Copy link
Copy Markdown
Collaborator Author

True. Do you think the CI check is overkill?

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Automation Github bots, testing workflows, release automation plan to merge Final call for comments

Projects

None yet

Development

Successfully merging this pull request may close these issues.

The "Tutorials" link on http://xarray.dev is broken

2 participants