From c034c88e91bcf4e7ca9212979ff1248141da580e Mon Sep 17 00:00:00 2001
From: Vinta Chen <vinta.chen@gmail.com>
Date: Sun, 16 Aug 2026 15:57:21 +0800
Subject: [PATCH] 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>
---
 .gitignore         |  8 +-------
 docs/audit-logs.md | 33 +++++++++++++++++++++++++++++++++
 2 files changed, 34 insertions(+), 7 deletions(-)
 create mode 100644 docs/audit-logs.md

diff --git a/.gitignore b/.gitignore
index b4d552e4..1f2c6f1e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -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/
diff --git a/docs/audit-logs.md b/docs/audit-logs.md
new file mode 100644
index 00000000..93fad35e
--- /dev/null
+++ b/docs/audit-logs.md
@@ -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