Skip to content

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

Merged
headtr1ck merged 6 commits into
pydata:mainfrom
headtr1ck:docs-missing-redirects
Oct 26, 2026
Merged

headtr1ck merged 6 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?

@keewis

keewis commented Oct 24, 2026

Copy link
Copy Markdown
Collaborator

not sure. Could also be a script (in ci/) so it can be run locally, but also there might be pages in the future where we don't have a obvious replacement (for example, because the page was split into pieces)

@headtr1ck
headtr1ck enabled auto-merge (squash) October 26, 2026 12:13
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@headtr1ck
headtr1ck merged commit 9fd73fd into pydata:main Oct 26, 2026
49 checks passed
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