Skip to content

fix: correct user guide URL in compatibility fallback messages#4854

Merged
andygrove merged 4 commits into
apache:mainfrom
andygrove:fix-4851-user-guide-url
Jul 8, 2026
Merged

fix: correct user guide URL in compatibility fallback messages#4854
andygrove merged 4 commits into
apache:mainfrom
andygrove:fix-4851-user-guide-url

Conversation

@andygrove

Copy link
Copy Markdown
Member

Which issue does this PR close?

Closes #4851.

Rationale for this change

Fallback messages emitted in query plans (and the scaladoc on SupportLevel) link to https://datafusion.apache.org/comet/user-guide/compatibility.html. After the user guide documentation was reorganized under a versioned latest/ path, the compatibility guide moved from a single page to a directory, so the old link is stale. The configured redirect (user-guide/compatibility.html -> latest/compatibility.html in docs/source/conf.py) also no longer resolves because the target is now a directory rather than an .html file.

What changes are included in this PR?

Update the compatibility guide URL used in fallback messages and scaladoc to the current canonical location:

https://datafusion.apache.org/comet/user-guide/latest/compatibility/index.html

This matches how the compatibility guide is linked elsewhere in the docs (for example docs/source/about/gluten_comparison.md).

Only the compatibility guide link is changed. The tuning guide link still redirects correctly because that page remained a single file.

How are these changes tested?

The changes are limited to documentation URL string literals. The updated URL was verified to return HTTP 200 on the published documentation site.

@andygrove andygrove requested a review from coderfender July 7, 2026 23:08
@andygrove andygrove merged commit 71758bc into apache:main Jul 8, 2026
69 checks passed
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.

Fallback messages have incorrect URL for user guide

2 participants