Skip to content

Conversation

alamb
Copy link
Contributor

@alamb alamb commented May 30, 2025

Which issue does this PR close?

Rationale for this change

Implement suggestions from @xudong963: #16139 (comment)

What changes are included in this PR?

Tweak the docs a bit

Are these changes tested?

Are there any user-facing changes?

@github-actions github-actions bot added the common Related to common crate label May 30, 2025
/// vectors represent the containers.
/// The order must match the order of the partition columns in
/// [`PartitionPruningStatistics::partition_schema`].
///
Copy link
Contributor Author

Choose a reason for hiding this comment

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

this was a driveby cleanup -- to add some whitespace for my whitespace OCD


/// Prune a set of containers represented by their statistics.
/// Each [`Statistics`] represents a container (e.g. a file or a partition of files).
///
Copy link
Contributor Author

Choose a reason for hiding this comment

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

This is the real change of the PR -- to reword this description to try and make it easier to understand

Copy link
Contributor

@comphead comphead left a comment

Choose a reason for hiding this comment

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

lgtm thanks @alamb

@comphead comphead merged commit 376eb03 into apache:main May 30, 2025
27 checks passed
@alamb alamb deleted the alamb/improve_docs_statistics branch June 1, 2025 15:08
Comment on lines +268 to +273
/// It is up to the caller to decide what each container represents. For
/// example, they can come from a file (e.g. [`PartitionedFile`]) or a set of of
/// files (e.g. [`FileGroup`])
///
/// [`PartitionedFile`]: https://docs.rs/datafusion/latest/datafusion/datasource/listing/struct.PartitionedFile.html
/// [`FileGroup`]: https://docs.rs/datafusion/latest/datafusion/datasource/physical_plan/struct.FileGroup.html
Copy link
Member

Choose a reason for hiding this comment

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

Nice!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
common Related to common crate
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants