Skip to content

Conversation

@jorisvandenbossche
Copy link
Member

@jorisvandenbossche jorisvandenbossche commented Dec 16, 2025

This expands the section a bit, trying to explain more what it actually is and can do. And also emphasized that it is "initial" support, to avoid people expect that it could be used everywhere (or to the extent that it can be used in other libraries like polars and pyspark)

For another issue, but we should also add a section about it in the user guide to refer to with a more complete / up to date description of how it can be used.

cc @MarcoGorelli

@MarcoGorelli
Copy link
Member

thanks!

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR enhances the documentation for the newly introduced pd.col() feature in pandas 3.0.0. The update expands the whatsnew section to provide clearer explanation of what pd.col() is, what it can do, and its current limitations. The changes also add a version annotation to the function's docstring and emphasize that this is "initial" support to set appropriate expectations.

  • Expanded whatsnew section with better explanation of pd.col() purpose and capabilities
  • Added versionadded directive to the col() function docstring
  • Clarified current scope and future expansion plans for the feature

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
pandas/core/col.py Added versionadded directive (3.0.0) to the col() function docstring
doc/source/whatsnew/v3.0.0.rst Expanded and restructured the pd.col() documentation section with clearer explanations, examples, and scope limitations

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@mroeschke mroeschke merged commit f4cd63d into pandas-dev:main Dec 16, 2025
50 of 52 checks passed
@mroeschke
Copy link
Member

Thanks @jorisvandenbossche

@jorisvandenbossche jorisvandenbossche deleted the doc-whatsnew-3.0-col branch December 16, 2025 17:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants