Skip to content

Clarify DataFrame row selection documentation - #7753

Open
svick wants to merge 1 commit into
mainfrom
svick/clarify-dataframe-filter-docs
Open

svick wants to merge 1 commit into
mainfrom
svick/clarify-dataframe-filter-docs

Conversation

@svick

@svick svick commented Oct 1, 2026 •

Copy link
Copy Markdown
Member
  • explain how Boolean DataFrame filters map values to rows, including shorter filters
  • document row-index ordering and repeated-index behavior for DataFrame indexers and DataFrameColumn.Clone overloads
  • clarify row-index semantics for cumulative and reduction methods and update the source template

Explain how Boolean filters and row-index collections select, order, and repeat rows and column values.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@svick
svick added this pull request to stack #7755 October 1, 2026 15:46
@svick
svick requested a balanced review from Copilot October 1, 2026 15:55

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🟡 Changes recommended

Some clone documentation contradicts implementation behavior or omits index-sequence truncation.

Review effort: Balanced
Findings: 2 Low severity

Open (2)
What changed in this PR

Clarifies row-selection and index-order semantics across the DataFrame API.

Changes:

  • Documents Boolean filtering and shorter filters.
  • Clarifies ordering and repeated-index behavior.
  • Updates cumulative/reduction documentation and its template.
File Description
PrimitiveDataFrameColumn.cs Documents clone selection semantics.
VBufferDataFrameColumn.cs Inherits clone documentation.
StringDataFrameColumn.cs Inherits clone documentation.
ArrowStringDataFrameColumn.cs Inherits clone documentation.
DataFrameColumn.cs Clarifies base clone contracts.
DataFrameColumn.Computations.tt Updates generated documentation template.
DataFrameColumn.Computations.cs Documents row-subset computations.
DataFrame.cs Clarifies filtering and indexers.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread src/Microsoft.Data.Analysis/PrimitiveDataFrameColumn.cs
@svick
svick marked this pull request as ready for review October 1, 2026 16:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants