Commit Graph
18 Commits
Author SHA1 Message Date
Vinta ChenandClaude 3cdca30d48 docs: record thealgorithms as a naming exception
thealgorithms isn't on PyPI and doesn't use its GitHub repo name, `Python`, as the naming rule requires, so it read as an unrecorded naming violation.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-02 15:24:21 +08:00
Vinta ChenandClaude 1236c5c5ab fix: map graphify to its graphifyy PyPI package
graphify's PyPI override was null (GitHub-only), so the site showed no download count although the project now publishes on PyPI as graphifyy.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-02 13:08:32 +08:00
Vinta ChenandClaude abff0608ab docs: record the 2026-10-02 audit overrides
Standing maintainer decisions (the August schedule and httpie keeps, uv-audit's experimental status, jev-ultrafast's admission, the three 6-entry caps) lived only in old commit bodies or conversation, so the next audit would re-drop them as rule failures.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-02 12:50:41 +08:00
Vinta ChenandClaude a7069559f2 docs: record AI & ML audit overrides
The 2026-10-02 AI & ML audit kept or admitted five Beta-classifier entries and kept annoy past the 12-month activity line, but docs/audit-logs.md did not record these maintainer decisions, so the next audit would drop them as rule failures.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-02 11:38:56 +08:00
Vinta ChenandClaude dfc8714afe docs: record claude-agent-sdk and semantica audit overrides
The 2026-10-01 AI and Agents audit kept claude-agent-sdk despite its Alpha classifier and semantica as a challenger without adoption-trajectory evidence, and neither override was on record in docs/audit-logs.md.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-01 20:45:46 +08:00
Vinta ChenandClaude 160d9c01f1 docs: record openviking and seleniumbase audit overrides
docs/audit-logs.md claimed every maintainer override is recorded, but the openviking stability override (PR #3302) and the seleniumbase challenger-evidence override (PR #3284) were missing.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 21:01:58 +08:00
Vinta ChenandClaude 66ac5fc775 docs: record 2026-08-23 audit sitting outcomes
Add a Stability Exceptions section to docs/audit-logs.md documenting
the zensical override (admitted pre-1.0 to displace a dying mkdocs
upstream). Add a matching evidence bullet to CLAUDE.md and AGENTS.md
warning that a download count is not automatically independent demand
when one listed entry depends on another, using mkdocs / mkdocs-material
as the worked example. Both facts were discovered during this sitting
and need to persist so the next audit doesn't rediscover them.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-23 00:50:17 +08:00
Vinta Chen 0e9ae0cb04 clean up 2026-08-16 16:25:10 +08:00
Vinta ChenandClaude c034c88e91 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>
2026-08-16 15:57:21 +08:00
Vinta ChenandClaude 553bf88c05 feat: replace acceptance lanes with shortlist admission rule
Land the shortlist-reform rules approved by the maintainer (rules
first; entry sweeps are not authorized yet).

- CONTRIBUTING.md: replace the Industry Standard / Rising Star / Hidden
  Gem lanes with a single admission rule per use case (up to 3 obvious
  choices + up to 2 challengers, hard max 5), add Displacement, the
  stdlib rule, and editorial-judgment-as-final evidence guidance; scope
  test becomes Serves Python Developers; document entry ordering
  (obvious choices then challengers, each alphabetical).
- README.md: add the shortlist promise paragraph pointing rejected
  contributors to linked awesome-* catalogs and to CONTRIBUTING.md.
- CLAUDE.md: sync Key Rules with the new ordering and shortlist cap,
  and add the prune-sweep one-commit-per-section exception.
- docs/adr/0001-shortlist-not-catalog.md: flip status from proposed to
  accepted.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-15 13:51:18 +08:00
Vinta ChenandClaude 9218024200 docs: fold serves-Python-developers scope test into ADR-0001
Per maintainer choice, the new scope test replaces the old primarily-written-in-Python (>50%) requirement: implementation language and packaging no longer matter as long as Python developers use the thing in their Python work (e.g. uv and ty are Rust; agent skill packs are markdown), while pure-Python projects nobody uses in Python work still don't qualify. Folded into the existing ADR rather than filed as a separate one.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-15 13:11:04 +08:00
Vinta ChenandClaude d4d518fc32 docs: fix stale claims in shortlist-not-catalog ADR
ADR review found three stale claims: an unreviewed Testing dry-run cited as
evidence for the projected list size, the Challenger path missing from the
lane-rejection rationale, and no mention of judgment overriding known
failure modes of the download-signal (CI/dependency-inflated counts, model
weights vs. pip installs, large-but-specific audiences misread as niche).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-15 13:07:31 +08:00
Vinta ChenandClaude bd657b3a85 docs: fix stale cap wording in shortlist ADR
Cap changed to 3 obvious choices + up to 2 challengers (hard max 5)
during review, but the ADR still described the old cap of 3 with at
most one challenger.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-15 13:04:22 +08:00
Vinta ChenandClaude 63146cc863 docs: capture shortlist-reform decisions on shortlist-reform branch
Records the outcome of a grilling session with the maintainer that
settled the redesign of awesome-python from a catalog into a curated
shortlist of Obvious Choices per Use Case. Execution is held pending
maintainer go-ahead, so these files let a fresh agent resume without
re-litigating settled decisions:

- CONTEXT.md: glossary of the editorial vocabulary (Use Case, Obvious
  Choice, Challenger, Displacement, Split, etc).
- docs/adr/0001-shortlist-not-catalog.md: the ADR recording the
  decision, considered options, and consequences (status: proposed).
- .gitignore: docs/ was wholesale-ignored; carve out docs/adr/ so the
  ADR can be tracked.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-15 13:00:16 +08:00
Vinta ChenandClaude 4af84dac8e remove mkdocs site infrastructure
Replace the MkDocs-based build (mkdocs.yml, requirements.txt, docs/CNAME,
docs/css/extra.css) with a custom website builder as part of the site relaunch.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-03-18 13:48:45 +08:00
Lint 13f9cc6a01 Removed dead css 2019-03-03 14:00:47 +05:30
Vinta 21ab061232 update mkdocs config 2018-04-11 02:11:11 +08:00
Vinta 65ef34f2d2 use MkDocs to generate a static website 2015-06-07 03:36:52 +08:00