Skip to content

DOC: Fixed all remaining GL02 documentation errors and added appropriate check in CI #43003

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

Merged
merged 8 commits into from
Aug 19, 2021

Conversation

fshi01
Copy link
Contributor

@fshi01 fshi01 commented Aug 12, 2021

@jreback
Copy link
Contributor

jreback commented Aug 13, 2021

there is a precommit failure

@jreback jreback added the Docs label Aug 13, 2021
@fshi01
Copy link
Contributor Author

fshi01 commented Aug 16, 2021

The pre-commit error is now fixed. The remaining errors stem from test_nat_doc_strings, which tests overlapping methods for matching docstrings.

In order to fix the remaining GL02 docstring errors, I had to overwrite the docstring for two methods from the parent class. In order to fix these two errors, the docstrings will not match. How should I proceed?

@MarcoGorelli MarcoGorelli self-requested a review August 16, 2021 17:38
@jreback
Copy link
Contributor

jreback commented Aug 16, 2021

right you will have to add these same methods to NaT (possibly adjusting the text)

Copy link
Member

@MarcoGorelli MarcoGorelli left a comment

Choose a reason for hiding this comment

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

As far I can tell, the issue is that the docstring from datetime doesn't conform to the requirements? If so, this looks good to me

@jreback jreback added this to the 1.4 milestone Aug 19, 2021
@jreback jreback merged commit b759e69 into pandas-dev:master Aug 19, 2021
@jreback
Copy link
Contributor

jreback commented Aug 19, 2021

thanks @fshi01 very nice!

feefladder pushed a commit to feefladder/pandas that referenced this pull request Sep 7, 2021
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