astral-sh / astral-sh/ruff

`D102` - Don't enforce docstrings on `__new__` and `__call__`

Open
#8,085 3 comments 11 reactions 0 assignees View on GitHub
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.