deprecate check-docstring-first without replacement

this hook has unfixable false positives and is not that useful

perhaps someone can write a flake8 plugin to replace the functionality
This commit is contained in:
anthony sottile 2025-11-22 15:09:09 -05:00
parent f4e025486b
commit d2cf95b9cf
2 changed files with 3 additions and 4 deletions

View file

@ -45,9 +45,6 @@ Require literal syntax when initializing empty or zero Python builtin types.
#### `check-case-conflict`
Check for files with names that would conflict on a case-insensitive filesystem like MacOS HFS+ or Windows FAT.
#### `check-docstring-first`
Checks for a common error of placing code before the docstring.
#### `check-executables-have-shebangs`
Checks that non-binary executables have a proper shebang.
@ -207,6 +204,8 @@ Trims trailing whitespace.
- `check-byte-order-marker`: instead use fix-byte-order-marker
- `fix-encoding-pragma`: instead use [`pyupgrade`](https://github.com/asottile/pyupgrade)
- `check-docstring-first`: fundamentally flawed, deprecated without replacement.
### As a standalone package