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

DOC: remove private parameters from method/constructor signatures #52019

Closed

Conversation

NumanIjaz
Copy link
Contributor

@NumanIjaz NumanIjaz commented Mar 16, 2023

The documentation (e.g. for Series constructor) contain the parameters which are used only internally (fastpath in case of Series). Now if a parameter is private and prefixed with an underscore _ it will not be part of the signature in the output.

Copy link
Member

@phofl phofl left a comment

Choose a reason for hiding this comment

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

This is an API change, we can't do this without deprecating.

@NumanIjaz
Copy link
Contributor Author

@phofl thanks for the review. Is there any guide on how we do the deprecation?

@phofl
Copy link
Member

phofl commented Mar 16, 2023

You should start by opening an issue to discuss it

@NumanIjaz
Copy link
Contributor Author

Created #52028 for the discussion.

@mroeschke
Copy link
Member

Seems like the issue needs more discussion before moving forward with a PR so closing for now, but we can reopen when theres more consensus

@mroeschke mroeschke closed this Mar 31, 2023
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.

DOC: Remove internally used/private parameters from method signatures
3 participants