-
-
Notifications
You must be signed in to change notification settings - Fork 19.4k
DOC: Fixed PR08 and PR09 docstring errors in pandas.Series #28845
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: Fixed PR08 and PR09 docstring errors in pandas.Series #28845
Conversation
| * Series | ||
| * Series: | ||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@datapythonista do we want the blank lines on 2280, 2283, 2285, ...?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not sure if we have a convention for that, but I don't think so. I think it'll be more readable without them, and markdown requires them for some implementations, but I don't think rst does.
datapythonista
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Great job, added few comments.
Note that the first line of Returns is the type (they look like description, but they shouldn't be). So, no period at the end should be added. See: https://dev.pandas.io/docs/development/contributing_docstring.html#section-4-returns-or-yields
| * Series | ||
| * Series: | ||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not sure if we have a convention for that, but I don't think so. I think it'll be more readable without them, and markdown requires them for some implementations, but I don't think rst does.
| * 'backfill' / 'bfill': use NEXT valid observation to fill. | ||
| how : {'start', 'end'}, default end | ||
| For PeriodIndex only, see PeriodIndex.asfreq | ||
| For PeriodIndex only (see PeriodIndex.asfreq). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Using next should make it a link I think:
:meth:`PeriodIndex.asfreq`
Co-Authored-By: Marc Garcia <[email protected]>
Co-Authored-By: Marc Garcia <[email protected]>
Co-Authored-By: Marc Garcia <[email protected]>
Co-Authored-By: Marc Garcia <[email protected]>
Co-Authored-By: Marc Garcia <[email protected]>
Co-Authored-By: Marc Garcia <[email protected]>
Co-Authored-By: Marc Garcia <[email protected]>
datapythonista
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Lgtm, thanks for all these fixes @jackbicknell14
|
Thanks a lot for the fixes @jackbicknell14 |
Fixed all PR08 and PR09 issues in pandas.Series.
black pandas