Skip to content

Conversation

@alamb
Copy link
Contributor

@alamb alamb commented Apr 18, 2023

Which issue does this PR close?

Closes #6042

Rationale for this change

I am trying to get the rustdoc API docs into better shape.

What changes are included in this PR?

  1. Fix cargo doc
  2. Add new gitub workflow action to check that docs build is clean

Are these changes tested?

Yes -- new lint

Are there any user-facing changes?

Some broken links in API docs are fixed

@github-actions github-actions bot added core Core DataFusion crate logical-expr Logical plan and expressions optimizer Optimizer rules physical-expr Changes to the physical-expr crates sql SQL Planner labels Apr 18, 2023
@waynexia
Copy link
Member

Great work 🚀 This is also very helpful for #5981

@alamb
Copy link
Contributor Author

alamb commented Apr 19, 2023

Thank @waynexia -- hopefully I'll have this PR ready to go shortly

@alamb alamb marked this pull request as ready for review April 19, 2023 11:58
@alamb alamb requested a review from waynexia April 19, 2023 11:58
Copy link
Member

@waynexia waynexia 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 this 🎉 I've run it locally and every link looks fine!

rust-version: stable
- name: Run cargo doc
run: |
export RUSTDOCFLAGS="-D warnings -A rustdoc::private-intra-doc-links"
Copy link
Member

Choose a reason for hiding this comment

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

👍

@alamb
Copy link
Contributor Author

alamb commented Apr 20, 2023

Thank you for the review @waynexia !

@alamb alamb merged commit d7ca977 into apache:main Apr 20, 2023
@alamb alamb deleted the alamb/cleanup_docs branch April 20, 2023 12:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

core Core DataFusion crate logical-expr Logical plan and expressions optimizer Optimizer rules physical-expr Changes to the physical-expr crates sql SQL Planner

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Fix rustdoc errors

2 participants