Skip to content
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

chore: add docs, part of #37 #6496

Merged
merged 1 commit into from
Oct 2, 2024
Merged

chore: add docs, part of #37 #6496

merged 1 commit into from
Oct 2, 2024

Conversation

ByteBaker
Copy link
Contributor

@ByteBaker ByteBaker commented Oct 2, 2024

Closes #37.

  • add pragma #![warn(missing_docs)] to parquet

    This is the final component in the effort to make Arrow fully-documented. The entire project now generates warning for missing docs, if any.

  • arrow-flight: replace tonic's deprecated compile_with_config with suggested method

  • New deprecation: The following types were not used anywhere and were possibly strays. They've been marked as deprecated and will be removed in future versions.

    • parquet::data_types::SliceAsBytesDataType
    • parquet::column::writer::Level

@github-actions github-actions bot added parquet Changes to the parquet crate arrow Changes to the arrow crate arrow-flight Changes to the arrow-flight crate labels Oct 2, 2024
- add pragma `#![warn(missing_docs)]` to `parquet`

This is the final component in the effort to make Arrow
fully-documented. The entire project now generates warning
for missing docs, if any.

- `arrow-flight`: replace `tonic`'s deprecated `compile_with_config`
with suggested method

- new deprecation:
The following types were not used anywhere and were possibly strays.
They've been marked as deprecated and will be removed in future
versions.

- `parquet::data_types::SliceAsBytesDataType`
- `parquet::column::writer::Level`
Copy link
Contributor

@alamb alamb left a comment

Choose a reason for hiding this comment

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

I love it -- thank you @ByteBaker

This is the kind of slog that I think makes the code overall better (and ensures going forward people doc things ❤️ )

🚀

arrow-flight/gen/src/main.rs Show resolved Hide resolved
parquet/src/column/writer/mod.rs Show resolved Hide resolved
parquet/src/data_type.rs Show resolved Hide resolved
@alamb
Copy link
Contributor

alamb commented Oct 2, 2024

I think this PR wins the award for lowest github issue number closed in a long time. 37!

@alamb alamb merged commit 5595019 into apache:master Oct 2, 2024
20 checks passed
@alamb alamb added documentation Improvements or additions to documentation development-process Related to development process of arrow-rs and removed development-process Related to development process of arrow-rs labels Oct 2, 2024
@ByteBaker ByteBaker deleted the require_docs branch October 2, 2024 21:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
arrow Changes to the arrow crate arrow-flight Changes to the arrow-flight crate documentation Improvements or additions to documentation parquet Changes to the parquet crate
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Enable "#![warn(missing_docs)]"
2 participants