Commit graph

38 commits

Author SHA1 Message Date
Vinta Chen
2d6b59c53d docs: update archive rejects now that Archives exists
The stream-zip and libarchive-c Rejected Additions lines said no archives use case exists; Archives now exists and is at cap, so the reasons say that instead.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-11-15 00:54:55 +08:00
Vinta Chen
bc2339d454 docs: log rejected compression candidates
Co-Authored-By: Claude <noreply@anthropic.com>
2026-11-15 00:44:35 +08:00
Vinta Chen
b2e37f102d docs: prune Rejected Additions to repos still starred
Rejected Additions now keeps only repos the maintainer still stars. The 103 lines for unstarred repos go, including rejections that came from PRs and audits, so a resubmitted PR for one of them is judged from scratch. The xberg-io/* organization line stays.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-11-08 22:02:51 +08:00
Vinta Chen
79317a98b4 docs: record rejections from the parked star review
Logs 19 starred projects declined on 2026-11-08 under Rejected Additions, so later scans skip them.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-11-08 21:58:42 +08:00
Vinta Chen
dfac20ba3e
docs: add voicute/onnx-wakeword to rejected additions
Co-Authored-By: Claude <noreply@anthropic.com>
2026-11-08 21:53:31 +08:00
Vinta Chen
4f64cf0717 docs: record star scan rejections
Logs 27 starred projects judged and declined on 2026-11-08 under Rejected Additions, so later scans skip them.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-11-08 21:25:59 +08:00
Vinta Chen
c125d3a490
docs: record evidence for five Mature-stable audit keeps
Five Mature-stable Keeps were bare names with no dates, downloads, or reason for staying.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-11-08 21:10:55 +08:00
Vinta Chen
d567435aab docs: record Documentation audit date
Co-Authored-By: Claude <noreply@anthropic.com>
2026-11-08 20:30:52 +08:00
Vinta Chen
521a213d87 docs: record zensical re-check and Material for MkDocs end of life
Co-Authored-By: Claude <noreply@anthropic.com>
2026-11-08 20:28:15 +08:00
Vinta Chen
3f6ed15ba9 feat: add magika to File Manipulation > File Type Detection
Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-16 17:26:39 +08:00
Vinta Chen
187b25bb1d audit: remove jev-ultrafast from Web Scraping > Frameworks
Removed: jev-ultrafast (no PyPI download signal; not published on PyPI): its README calls it an MVP and it needs a hosted API key, so the challenger slot goes to scrapling in the next commit. This overrides the Challenger Exception recorded 2026-10-02.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-16 17:26:03 +08:00
Vinta Chen
05d9798280 feat: add hyperopt to Machine Learning > Hyperparameter Optimization
Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-16 17:25:28 +08:00
Vinta Chen
51ccfccf3b docs: record 82 star-scan rejections
Each line keeps the ClickPy downloads and the reason at decision time, so later PR reviews and star scans don't propose these projects again without new evidence.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-16 17:21:50 +08:00
Vinta Chen
723d0cae6e
docs: record dacite, autoregistry, schedium, dishka, python-dependency-injector, xberg-io rejections
Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-16 14:15:37 +08:00
Vinta Chen
11f5e2ceab
feat: add scan-stars skill and Rejected Additions register
Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-16 14:12:14 +08:00
Vinta Chen
4b445a2cad docs: record gensim as a mature-stable keep
Some checks are pending
CI / test (push) Waiting to run
Deploy Website / deploy (push) Waiting to run
gensim's last push was 2025-11-01, so it crosses the 12-month activity line on 2026-11-01. It is kept on 2,904,015 downloads/month (ClickPy, 2026-10-12).
2026-10-15 15:09:44 +08:00
Vinta Chen
11ff78ee85 docs: record no-change audits for 28 sections
Every entry in these sections was re-checked against ClickPy downloads (2026-10-12) and live repo and PyPI state (2026-10-15); none needed a keep, drop, tier, or order change.
2026-10-15 13:18:50 +08:00
Vinta Chen
d5f917d063
docs: add priority ranking mode to audit-the-list
Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-14 21:35:45 +08:00
Vinta Chen
226106267d docs: correct ranking, project count, and challenger wording
DESIGN.md claimed ~650 projects (README has 506) and omitted the Downloads column the table sorts by; CONTRIBUTING.md said GitHub-linked projects rank higher when build.py sorts by PyPI downloads first and uses stars only for entries without downloads; ADR 0001 said challengers are "marked" while CONTRIBUTING.md says position is the only marker.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-11 09:47:37 +08:00
Vinta Chen
c70226eccf
docs: drop CONTEXT.md and fold its unique rules into CONTRIBUTING.md
Some checks are pending
CI / test (push) Waiting to run
Deploy Website / deploy (push) Waiting to run
CONTEXT.md duplicated CONTRIBUTING.md's vocabulary, and CONTRIBUTING.md used the term Second Tier without defining it.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-10 19:08:02 +08:00
Vinta Chen
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 Chen
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 Chen
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 Chen
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 Chen
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 Chen
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 Chen
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 Chen
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 Chen
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 Chen
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 Chen
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 Chen
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 Chen
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 Chen
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