`D102` - Don't enforce docstrings on `__new__` and `__call__`
Open
docstring
needs-decision
- Dominant language
- Rust
- Stars
- 49.6k
- Forks
- 2.4k
- Avg merge
- 2d 1h
- Merged PRs (30d)
- 458
Description
re-raising https://github.com/PyCQA/pydocstyle/issues/515 here:
> This should be considered a magic method (controlled by `D105`), or at least have a different error code (which may be `D107` together with `__init__` or even a new one).
Contributor guide
Research direction
Start by tracing Ruff's D102 rule handling and compare it with the linked pydocstyle issue 515. Determine the intended relationship among D102, D105, and D107, then update the relevant behavior and tests so __new__ and __call__ are no longer incorrectly required to have docstrings.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python, rust
- Domain
- tooling
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 38/100