docs: add audit log registry for maintainer overrides

Git history already archives every removal's reason via commit body,
but it can't be scanned at a glance. docs/audit-logs.md is the
at-a-glance register of overrides (naming exceptions, mature-stable
keeps) allowed by CONTRIBUTING.md. Drop the docs/* gitignore exclusion
(and stale .superpowers/ and skills-lock.json entries) so the file and
future doc additions outside docs/adr/ can be tracked.

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Vinta Chen
2026-08-16 15:57:21 +08:00
co-authored by Claude
parent 39eeab7dff
commit c034c88e91
2 changed files with 34 additions and 7 deletions
+1 -7
View File
@@ -13,12 +13,6 @@ __pycache__/
website/output/
website/data/
# docs (except decision records)
docs/*
!docs/adr/
# agents
tmp/
.superpowers/
.playwright-cli/
skills-lock.json
tmp/
+33
View File
@@ -0,0 +1,33 @@
# Audit Log
awesome-python is audited section by section. Every entry gets re-verified against live data, and every removal lands in a commit whose body carries the reason. Git history is the archive. This file is the at-a-glance register of maintainer decisions that a single commit can't show.
## Overrides
[CONTRIBUTING.md](../CONTRIBUTING.md) allows the maintainer to exceed any limit for a specific entry or use case. Each override is recorded here.
### Naming Exceptions
Display names follow the canonical PyPI package name. These entries keep a different name by maintainer decision:
- autobahn-python -- `autobahn`.
- django-rest-framework -- `djangorestframework`.
- django-rules -- `rules`.
- fasthtml -- `python-fasthtml`.
- jinja -- `Jinja2`.
- mem0 -- `mem0ai`.
- pangu.py -- `pangu`.
- playwright-python -- `playwright`.
- pytorch -- `torch`.
- strawberry -- `strawberry-graphql`.
- strawberry-django -- `strawberry-graphql-django`.
### Mature-stable Keeps
These entries sit past the 12-month activity requirement without an override. Each one is kept by editorial judgment: mature, stable, and no successor exists.
- sortedcontainers
- jinja
- itsdangerous
- jieba
- ftfy