Profile README: badge tables per category#28
Merged
Conversation
Spec for reworking profile/README.md into a metrics-forward layout: org-standards badge strip (uv/ruff/ty/coverage) plus per-category project tables with live per-repo badges (stars, version, downloads, Context7), templates handled in a separate PyPI-column-free table. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Adds plan.md (four tasks: rewrite README, verify badges/links live, promote architecture/org-profile.md, finalize + PR) and refines design.md with verified per-repo data (all libs on PyPI + Context7; templates 404 on PyPI but have Context7 pages, so they get a Context7 badge too). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Reworks
profile/README.mdfrom prose bullet lists into a metrics-forward layout:uv·Ruff·ty· staticcoverage 100%(justified by every repo's CI 100%-coverage guard).Project | What it is | Badges), keeping the existing grouping. Library rows carry live badges — GitHub stars, PyPI version, monthly downloads (static.pepy.tech), and a Context7 docs link. The two templates get a separate table with stars + Context7 + atype: templatechip (no PyPI columns, since they aren't published), so no empty/ragged cells.All 45 badge images and 77 link targets were verified live (HTTP 200). PyPI dist name == repo name for every package; all 15 libraries are on PyPI with Context7 pages; both templates 404 on PyPI but have Context7 pages.
Promotes the change into a new
architecture/org-profile.mdcapability page (the profile structure was previously unowned —brand-marks.mdonly covers logo assets). Spec + plan inplanning/changes/2026-06-30.05-profile-badge-tables/.Two background research sweeps informed the design (and are noted in the spec's motivation): no surveyed org puts a per-repo badge table in its profile, and the dominant failure mode is staleness — both addressed by the all-live-shields, per-category, template-separated approach.
Gate:
just defaultgreen (planning OK + 93/93 pytest).🤖 Generated with Claude Code