Skip to content

add redirect for old upgrading.html URL to fix broken changelog links#20582

Merged
alamb merged 1 commit intoapache:mainfrom
mishop-15:fix-upgrading-redirect
Feb 26, 2026
Merged

add redirect for old upgrading.html URL to fix broken changelog links#20582
alamb merged 1 commit intoapache:mainfrom
mishop-15:fix-upgrading-redirect

Conversation

@mishop-15
Copy link
Contributor

@mishop-15 mishop-15 commented Feb 26, 2026

Which issue does this PR close?

Rationale for this change

When upgrade guides were split into separate pages (#20183), the old upgrading.html URL broke. All changelog files still reference this old URL, causing 404 errors for users.

What changes are included in this PR?

Added a redirect in docs/source/conf.py using the existing sphinx_reredirects extension to redirect library-user-guide/upgrading.html to library-user-guide/upgrading/index.html.

This preserves all existing changelog links without needing to update historical files.

Are these changes tested?

Tested locally - the redirect works correctly, including with anchor links (e.g., upgrading.html#datafusion-46-0-0).

Are there any user-facing changes?

Yes - users clicking old changelog links will now be redirected to the correct page instead of getting a 404.

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Feb 26, 2026
redirects = {
"library-user-guide/adding-udfs": "functions/index.html",
"user-guide/runtime_configs": "configs.html",
"library-user-guide/upgrading": "/library-user-guide/upgrading/index.html",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's give it a try -- thank you @mishop-15 🙏

@alamb alamb added this pull request to the merge queue Feb 26, 2026
Merged via the queue into apache:main with commit a257c29 Feb 26, 2026
7 checks passed
@alamb
Copy link
Contributor

alamb commented Feb 26, 2026

This has fixed the problem 🙏

These links now work as expected: https://datafusion.apache.org/library-user-guide/upgrading/index.html

Thank you so much @mishop-15

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

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Broken links in changelogs

2 participants