Skip to content

[DOC] Make build_analyzer docstring more precise#13786

Merged
rth merged 2 commits intoscikit-learn:masterfrom
theotheo:patch-1
Jul 3, 2019
Merged

[DOC] Make build_analyzer docstring more precise#13786
rth merged 2 commits intoscikit-learn:masterfrom
theotheo:patch-1

Conversation

@theotheo
Copy link
Copy Markdown
Contributor

@theotheo theotheo commented May 4, 2019

Minor doc fix.

Copy link
Copy Markdown
Member

@jnothman jnothman left a comment

Choose a reason for hiding this comment

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

Thanks


def build_analyzer(self):
"""Return a callable that handles preprocessing and tokenization"""
"""Return a callable that handles preprocessing, tokenization and n-grams generation"""
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Please keep lines under 80 characters

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Also from https://www.python.org/dev/peps/pep-0257/

Multi-line docstrings consist of a summary line just like a one-line docstring, followed by a blank line, followed by a more elaborate description. The summary line may be used by automatic indexing tools; it is important that it fits on one line and is separated from the rest of the docstring by a blank line.

So we can't add a newline break here ether. The only solution could be to remove some words from the summary line.

@jnothman
Copy link
Copy Markdown
Member

jnothman commented May 5, 2019 via email

@rth
Copy link
Copy Markdown
Member

rth commented Jul 3, 2019

Addressed comments. Merging. Thanks!

@rth rth merged commit 09b3eb1 into scikit-learn:master Jul 3, 2019
koenvandevelde pushed a commit to koenvandevelde/scikit-learn that referenced this pull request Jul 12, 2019
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.

3 participants