asolimando opened a new pull request, #25699:
URL: https://github.com/apache/datafusion/pull/25699
## Which issue does this PR close?
Closes #25698.
## Rationale for this change
`StatisticsRegistry` and `ExtendedStatistics` each had a `# Example` doc
block wrapped in
` ```ignore `, so it was never compiled or checked by `cargo test --doc`.
`StatisticsContext::compute_extended` had no example at all.
## What changes are included in this PR?
- Add a real, compiled `# Example` to `StatisticsContext::compute_extended`.
- Convert the `StatisticsRegistry` module doc example from `ignore` to a
real doctest.
- Convert the `ExtendedStatistics` struct doc example from `ignore` to a
real doctest.
- The shared running example is a cross-column correlation extension
(`ColumnCorrelation`), since it is a genuinely node-level statistic,
unlike a
per-column histogram, which has no home in the current single node-level
`Extensions` field.
## Are these changes tested?
Yes, each doc comment is now a doctest, verified by `cargo test --doc`.
## Are there any user-facing changes?
No, this is a documentation-only change to public API doc comments.
----
Disclaimer: I used AI to assist in the code generation, I have manually
reviewed the output and it matches my intention and understanding.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
