Pull Request Overview

Opened on October 1, 2026
Status Open
Commit count 7 with first commit September 29, 2026

Total Delta

325 Total Diff Delta

Open Days

Open 2 weekdays

Test Delta

54 Diff Delta in Test Files

Breakdown by Phase

How long has this pull request spent in each phase of its lifecycle?

Fraction of total time	Business days	Phase
	1.8 days	Authoring 5 commits before pull request opened for review
	0.0 days	Awaiting first review
	1.2 days	Revising work with 2 commits in response to 0 reviews that left 3 comments

Total time for pull request still awaiting merge: 3.0 business days

[ci] [python-package] enforce 'numpydoc-validation' and 'pydoclint' checks

Contributes to #7470

Proposes adding numpydoc-validation and pydoclint, 2 linters that enforce standardization and correctness of Python docstrings. These caught a few issues (like eval_{X,y} missing from the Dask docstrings.

Both are fast enough to not be noticeable.

I think they'll help a lot with consistency and standardization, and relieve a small bit of review burden.

Notes for Reviewers

I tried to choose configurations for these tools that as closely as possible match the project's current conventions. See inline comments below.

I've added this branch (temporarily) to readthedocs configuration.

example build: https://app.readthedocs.org/projects/lightgbm/builds/34868017/

Comments Threads Pending Resolution

python-package/lightgbm/dask.py

         eval_init_score: Optional[List[_DaskCollection]] = None,
         eval_metric: Optional[_LGBM_ScikitEvalMetricType] = None,
         *,
         categorical_feature: _LGBM_CategoricalFeatureConfiguration = "auto",

.ci/parameter-generator.py

     -------
     list
         Names of all parameters.
     """  # noqa: DOC105

Resolved Comment Threads