Skip to content

[MRG] Fix typos in datasets documentation#13474

Merged
qinhanmin2014 merged 3 commits intoscikit-learn:masterfrom
christopherchoe:patch-1
Mar 20, 2019
Merged

[MRG] Fix typos in datasets documentation#13474
qinhanmin2014 merged 3 commits intoscikit-learn:masterfrom
christopherchoe:patch-1

Conversation

@christopherchoe
Copy link
Copy Markdown
Contributor

Changed spelling and grammar typos on lines 53 (spelling miscellaneous), 174 (Beginning of sentence not capitalized), 264 (grammar implies images not image).

Reference Issues/PRs

What does this implement/fix? Explain your changes.

Any other comments?

Changed spelling and grammar typos on lines 53 (spelling miscellaneous), 174 (Beginning of sentence not capitalized), 264 (grammar implies images not image).
datasets that are challenging to certain algorithms (e.g. centroid-based
clustering or linear classification), including optional Gaussian noise.
They are useful for visualisation. produces Gaussian
They are useful for visualisation. Produces Gaussian
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.

this seems strange, maybe ..., and to produce...?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I agree, but wasn't sure on what the message was trying to convey so I went with the smallest change possible. And to produce would seem to convey the same message and be clearer.

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.

Only make_circles produces a spherical decision function so the sentence does not apply to both.

How about:

:func:make_circles produces Gaussian data with a spherical decision boundary for binary classification, while :func:make_moons produces two interleaving half circles.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Yeah definitely thought maybe that there might be a different meaning because the sentence seemed to be unfinished. I changed it and changed the formatting by adding backquotes.

:func:make_circles ... :func:make_moons` ...

This was to match with other references in the documentation, please tell me if that shouldn't be the case in this instance. Thank you

Changed to accurately represent the visualization of :func:make_circles and :func:make_moons
Copy link
Copy Markdown
Member

@NicolasHug NicolasHug left a comment

Choose a reason for hiding this comment

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

line length issue, LGTM otherwise!

clustering or linear classification), including optional Gaussian noise.
They are useful for visualisation. produces Gaussian
data with a spherical decision boundary for binary classification.
They are useful for visualisation. :func:`make_circles` produces Gaussian data with a spherical decision boundary for binary classification, while :func:`make_moons` produces two interleaving half circles.
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 avoid long lines: split this into multiple lines with approximately 80 characters

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Fixed, thanks for the input!

Fixed documentation to not go over 80 characters
Copy link
Copy Markdown
Member

@qinhanmin2014 qinhanmin2014 left a comment

Choose a reason for hiding this comment

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

LGTM, thanks @christopherchoe

@qinhanmin2014 qinhanmin2014 merged commit e4ea963 into scikit-learn:master Mar 20, 2019
xhluca pushed a commit to xhluca/scikit-learn that referenced this pull request Apr 28, 2019
xhluca pushed a commit to xhluca/scikit-learn that referenced this pull request Apr 28, 2019
xhluca pushed a commit to xhluca/scikit-learn that referenced this pull request Apr 28, 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