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: Fix GL01 and GL02 errors in the docstrings #27988

Merged
merged 10 commits into from Aug 24, 2019

Conversation

steveayers124
Copy link
Contributor

@steveayers124 steveayers124 commented Aug 18, 2019

Fixed docstrings text that aren’t on the next line after opening """ and followed immediately by the line with closing """. Issue #27986

…and be followed immediately by the line with closing `"""`.
…and be followed immediately by the line with closing `"""`.
@pep8speaks
Copy link

pep8speaks commented Aug 18, 2019

Hello @steveayers124! Thanks for updating this PR. We checked the lines you've touched for PEP 8 issues, and found:

There are currently no PEP 8 issues detected in this Pull Request. Cheers! 🍻

Comment last updated at 2019-08-24 05:57:03 UTC

…and be followed immediately by the line with closing `"""`.
…and be followed immediately by the line with closing `"""`.
…and be followed immediately by the line with closing `"""`.
@datapythonista datapythonista changed the title Fixed docstrings text that aren’t on the next line after opening """ and followed immediately by the line with closing """. Issue #27986 DOC: Fix GL01 and GL02 errors in the docstrings Aug 18, 2019
Copy link
Member

@datapythonista datapythonista left a comment

Choose a reason for hiding this comment

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

Good work, thanks for working on these @steveayers124.

I see that the CI is red, and that pep8speaks complaint about couple of lines being too long. Can you check the CI and fix any errors, so everything is green and we can merge please? Thanks!

@steveayers124
Copy link
Contributor Author

I appreciate your review, and encouragement, @datapythonista. I'll try going in smaller increments to see maybe what's failing, when I try more pull requests on my remaining changes. Thanks for the feedback!

Copy link
Member

@datapythonista datapythonista left a comment

Choose a reason for hiding this comment

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

looks great, thanks @steveayers124 for the work on this.

@WillAyd WillAyd added this to the 1.0 milestone Aug 24, 2019
Copy link
Member

@WillAyd WillAyd left a comment

Choose a reason for hiding this comment

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

Minor comments otherwise lgtm

@@ -123,18 +123,22 @@ def ip():

@pytest.fixture(params=[True, False, None])
def observed(request):
""" pass in the observed keyword to groupby for [True, False]
"""
Pass in the observed keyword to groupby for [True, False]
Copy link
Member

Choose a reason for hiding this comment

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

I think need a blank line separating short description from long description here

@@ -234,15 +238,16 @@ def cython_table_items(request):


def _get_cython_table_params(ndframe, func_names_and_expected):
"""combine frame, functions from SelectionMixin._cython_table
"""
Combine frame, functions from SelectionMixin._cython_table
Copy link
Member

Choose a reason for hiding this comment

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

Short description should be one line

@datapythonista
Copy link
Member

Agree on both @WillAyd. But I'm also happy to have them in a follow up. GL01 and GL02 are about the position of the quotes, and for formatting errors I'd say it may speed up things if we merge PRs fast and keep opening new tickets fast, than trying to address too many in the PRs.

I'm writing a blog post about what I think it makes sense, so we can discuss and find the way that we all find more efficient. But there is so much to say that it's taking forever. :)

@WillAyd
Copy link
Member

WillAyd commented Aug 24, 2019 via email

@datapythonista datapythonista merged commit 5c0da7d into pandas-dev:master Aug 24, 2019
@datapythonista
Copy link
Member

Thanks @steveayers124, keep the good work.

galuhsahid pushed a commit to galuhsahid/pandas that referenced this pull request Aug 25, 2019
galuhsahid added a commit to galuhsahid/pandas that referenced this pull request Aug 25, 2019
* master: (40 commits)
  DOC: Fix GL01 and GL02 errors in the docstrings (pandas-dev#27988)
  Remove Encoding of values in char** For Labels (pandas-dev#27618)
  TYPING: more type hints for io.formats.printing (pandas-dev#27765)
  TST: fix compression tests when run without virtualenv/condaenv (pandas-dev#28051)
  DOC: Start 0.25.2 (pandas-dev#28111)
  DOC: Fix docstrings lack of punctuation (pandas-dev#28031)
  DOC: Remove alias for numpy.random.randn from the docs (pandas-dev#28082)
  DOC: update GroupBy.head()/tail() documentation (pandas-dev#27844)
  BUG: timedelta merge asof with tolerance (pandas-dev#27650)
  BUG: Series.rename raises error on values accepted by Series construc… (pandas-dev#27814)
  Preserve index when setting new column on empty dataframe. (pandas-dev#26471)
  BUG: Fixed groupby quantile for listlike q (pandas-dev#27827)
  BUG: iter with readonly values, closes pandas-dev#28055 (pandas-dev#28074)
  TST: non-strict xfail for period test (pandas-dev#28072)
  DOC: Update whatsnew (pandas-dev#28073)
  CI: disable codecov (pandas-dev#28065)
  CI: Set SHA for codecov upload (pandas-dev#28067)
  BUG: Correct the previous bug fixing on xlim for plotting (pandas-dev#28059)
  CI: Add pip dependence explicitly (pandas-dev#28008)
  DOC: Change document code prun in a row (pandas-dev#28029)
  ...
proost pushed a commit to proost/pandas that referenced this pull request Dec 19, 2019
proost pushed a commit to proost/pandas that referenced this pull request Dec 19, 2019
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.

DOC: Fix some GL01/GL02 docstring errors
4 participants