Skip to content

fix(docs): Update broken links to TableProvider docs #16830

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 21, 2025

Conversation

jcsherin
Copy link
Contributor

Which issue does this PR close?

  • Closes #.

Rationale for this change

Fixes broken links to the TableProvider trait in the Rust and website docs. I found them while manually browsing the docs.

The following links are broken:

  • https://docs.rs/datafusion/latest/datafusion/datasource/provider/trait.TableProvider.html
  • https://docs.rs/datafusion/latest/datafusion/datasource/provider/trait.TableProvider.html#tymethod.scan
  • The TableProvider link on the Building Logical Plans library user guide.

What changes are included in this PR?

To find all instances, I grepped the codebase for the common path datafusion/datasource/provider and fixed the links I found.

Noter: Other broken links may still exist. I tried using cargo deadlinks to detect them automatically but the output was too verbose. I'll explore this later.

Are these changes tested?

Verified that the updated TableProvider links work correctly by building the docs in local locally and manually checking the following generated pages:

  • /target/doc/datafusion/catalog/default_table_source/struct.DefaultTableSource.html
  • /target/doc/datafusion/logical_expr/trait.TableSource.html
  • /docs/build/html/library-user-guide/building-logical-plans.html

Are there any user-facing changes?

No.

@github-actions github-actions bot added documentation Improvements or additions to documentation logical-expr Logical plan and expressions catalog Related to the catalog crate labels Jul 20, 2025
Copy link
Contributor

@2010YOUY01 2010YOUY01 left a comment

Choose a reason for hiding this comment

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

Thanks for the fix

Noter: Other broken links may still exist. I tried using cargo deadlinks to detect them automatically but the output was too verbose. I'll explore this later.

I tried, and that's true. There are many errors I don't understand.
Perhaps we can first filter, and only check there are no 404 pages in the src comments 🤔

@2010YOUY01 2010YOUY01 merged commit 9d6a443 into apache:main Jul 21, 2025
28 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
catalog Related to the catalog crate documentation Improvements or additions to documentation logical-expr Logical plan and expressions
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants