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

TST Enable numpydoc validation default #20304

Merged
merged 7 commits into from Jun 20, 2021

Conversation

@thomasjpfan
Copy link
Member

@thomasjpfan thomasjpfan commented Jun 19, 2021

This PR changes the logic of this to have an "ignore list". This way we can ensure that our docstrings are always validated once we fix the ones in DOCSTRING_IGNORE_LIST.

I see this as a sprint item where contributors can:

  1. Choose a estimator in DOCSTRING_IGNORE_LIST.
  2. Remove the estimator from the list.
  3. Run pytest maint_tools/test_docstrings.py -k SGDClassifier
  4. Fix errors.

CC @rth

Copy link
Member

@ogrisel ogrisel left a comment

Good idea and LGTM.

@rth
rth approved these changes Jun 20, 2021
Copy link
Member

@rth rth left a comment

Thanks @thomasjpfan !

@rth
Copy link
Member

@rth rth commented Jun 20, 2021

Should we maybe do this as part of the lint job if it doesn't take too long?

@thomasjpfan
Copy link
Member Author

@thomasjpfan thomasjpfan commented Jun 20, 2021

Should we maybe do this as part of the lint job if it doesn't take too long?

We can try to do this as a part of lint when numpydoc validation passes everywhere.

@rth
Copy link
Member

@rth rth commented Jun 20, 2021

OK, that works.

@rth rth merged commit bb6117b into scikit-learn:main Jun 20, 2021
30 checks passed
30 checks passed
@github-actions
check
Details
@github-actions
triage
Details
@github-actions
Check build trigger
Details
@github-actions
Build wheel for cp${{ matrix.python }}-${{ matrix.platform_id }}-${{ matrix.manylinux_image }}
Details
@github-actions
triage_file_extensions
Details
@github-actions
Source distribution
Details
@github-actions
Upload to Anaconda
Details
@lgtm-com
LGTM analysis: C/C++ No code changes detected
Details
@lgtm-com
LGTM analysis: JavaScript No code changes detected
Details
@lgtm-com
LGTM analysis: Python No new or fixed alerts
Details
ci/circleci: deploy Your tests passed on CircleCI!
Details
ci/circleci: doc Your tests passed on CircleCI!
Details
@circleci-artifacts-redirector
ci/circleci: doc artifact Link to 0/doc/_changed.html
Details
ci/circleci: doc-min-dependencies Your tests passed on CircleCI!
Details
ci/circleci: lint Your tests passed on CircleCI!
Details
@codecov
codecov/patch Coverage not affected when comparing 617ff6e...a1f57d2
Details
@codecov
codecov/project 97.99% (+0.00%) compared to 617ff6e
Details
@azure-pipelines
scikit-learn.scikit-learn Build #20210620.6 succeeded
Details
@azure-pipelines
scikit-learn.scikit-learn (Get Git Commit) Get Git Commit succeeded
Details
@azure-pipelines
scikit-learn.scikit-learn (Linting) Linting succeeded
Details
@azure-pipelines
scikit-learn.scikit-learn (Linux py37_conda_openblas) Linux py37_conda_openblas succeeded
Details
@azure-pipelines
scikit-learn.scikit-learn (Linux pylatest_pip_openblas_pandas) Linux pylatest_pip_openblas_pandas succeeded
Details
@azure-pipelines
scikit-learn.scikit-learn (Linux ubuntu_atlas) Linux ubuntu_atlas succeeded
Details
@azure-pipelines
scikit-learn.scikit-learn (Linux32 debian_atlas_32bit) Linux32 debian_atlas_32bit succeeded
Details
@azure-pipelines
scikit-learn.scikit-learn (Linux_Runs pylatest_conda_mkl) Linux_Runs pylatest_conda_mkl succeeded
Details
@azure-pipelines
scikit-learn.scikit-learn (Ubuntu_Bionic py37_conda) Ubuntu_Bionic py37_conda succeeded
Details
@azure-pipelines
scikit-learn.scikit-learn (Windows py37_conda_mkl) Windows py37_conda_mkl succeeded
Details
@azure-pipelines
scikit-learn.scikit-learn (Windows py37_pip_openblas_32bit) Windows py37_pip_openblas_32bit succeeded
Details
@azure-pipelines
scikit-learn.scikit-learn (macOS pylatest_conda_forge_mkl) macOS pylatest_conda_forge_mkl succeeded
Details
@azure-pipelines
scikit-learn.scikit-learn (macOS pylatest_conda_mkl_no_openmp) macOS pylatest_conda_mkl_no_openmp succeeded
Details
sakib-rahman-bangladesh added a commit to sakib-rahman-bangladesh/scikit-learn that referenced this pull request Jun 22, 2021
TST Enable numpydoc validation default (scikit-learn#20304)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Linked issues

Successfully merging this pull request may close these issues.

None yet

3 participants