8000 DOC Minor fixes for parameter documentation in ridge by alexitkes · Pull Request #14453 · scikit-learn/scikit-learn · GitHub
[go: up one dir, main page]

Skip to content

DOC Minor fixes for parameter documentation in ridge #14453

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

Conversation

alexitkes
Copy link
Contributor

Address #14452

  • Document default values for alpha and tol parameters for Ridge class
  • Document default values for alpha, fit_intercept and tol parameters for RidgeClassifier class
  • Document default values for alphas parameter for RidgeCV class
  • Document default values for alphas and fit_intercept parameters for RidgeClassifierCV class

Copy link
Member
@rth rth left a comment

Choose a reason for hiding this comment

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

Thanks @alexitkes ! A few comments are below,

@alexitkes alexitkes changed the title Minor fixes for parameter documentation in ridge [MRG] Minor fixes for parameter documentation in ridge Jul 24, 2019
@jnothman
Copy link
Member

Should it be using default=?

@alexitkes
Copy link
Contributor Author

@jnothman I can do it if needed, but I see most parameters in Ridge classes are documented in form default None though some are documented as default=True or default: False. The standardization of parameter docstrings seems being discussed #14404 . Is the default= form already surely preferable?

@amueller
Copy link
Member

@alexitkes yes I'm pretty sure it is.

@alexitkes
Copy link
Contributor Author

@amueller @jnothman Ok, done it.

@adrinjalali
Copy link
Member

I'd probably wait and follow whatever is the conclusion in #12356

boolean -> bool
Remove unnecessary notes about iterable being converted to Numpy array
Document the float/array parameters that are set to None by default.
Make too long lines shorter.
`default None` -> `default=None`
Replace `optional, default=...` docstrings with just `default=...`.
boolean -> bool
@alexitkes alexitkes force-pushed the alexitkes/linear-model-param-default-values branch from fa2272f to fcbe53b Compare October 7, 2019 15:45
@jnothman jnothman requested a review from rth October 8, 2019 05:10
Copy link
Member
@rth rth left a comment

Choose a reason for hiding this comment

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

A few minor comments, thanks @alexitkes !

alexitkes and others added 7 commits October 8, 2019 16:47
Specify array shape as (n_samples,) instead of [n_samples]

Co-Authored-By: Roman Yurchak <rth.yurchak@gmail.com>
Update parameter type description

Co-Authored-By: Roman Yurchak <rth.yurchak@gmail.com>
Update parameter type description

Co-Authored-By: Roman Yurchak <rth.yurchak@gmail.com>
Update array shape description in parameter documentation

Co-Authored-By: Roman Yurchak <rth.yurchak@gmail.com>
Update array shape description

Co-Authored-By: Roman Yurchak <rth.yurchak@gmail.com>
Update parameter type documentation

Co-Authored-By: Roman Yurchak <rth.yurchak@gmail.com>
@rth rth changed the title [MRG] Minor fixes for parameter documentation in ridge DOC Minor fixes for parameter documentation in ridge Oct 8, 2019
@rth rth merged commit 45ac1ef into scikit-learn:master Oct 8, 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.

5 participants
0