mirror of
https://github.com/vinta/awesome-python.git
synced 2026-10-02 08:23:10 +08:00
docs: codify the Override rule in CONTRIBUTING and CONTEXT
Resolves decision 10's reservation on maintainer word: the 3+2/5 cap numbers stay as written — across the full prune they held everywhere except a handful of explicit overrides — and the override practice itself becomes a written rule: the maintainer may exceed any limit for a specific entry or use case by explicit decision, case-by-case, carrying no weight for submissions. CONTEXT.md gains the matching Override vocabulary entry. Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -23,6 +23,8 @@ Each use case lists at most:
|
||||
|
||||
Hard maximum: 5 entries per use case. This is a qualitative bar first and a numeric backstop second — most use cases should carry fewer.
|
||||
|
||||
**Overrides**: the maintainer may exceed any limit on this page — the caps, the activity requirement, the stability requirement — for a specific entry or use case by explicit decision. An override is case-by-case; it does not loosen these rules for submissions, and citing one in a PR carries no weight.
|
||||
|
||||
**Displacement**: once a use case is at its cap, the only way in is to name the entry your project replaces and argue that yours does that entry's job better. One in, one out.
|
||||
|
||||
**Standard library**: a standard-library module is listed only where the stdlib is itself the obvious choice for the use case (tomllib yes, unittest no).
|
||||
|
||||
Reference in New Issue
Block a user