Skip to content

docs: DOWNLOADS.md, proof of the rules download count - #230

Merged
sairenchristianbuerano merged 3 commits into
mainfrom
docs/download-counts
Nov 9, 2026
Merged

sairenchristianbuerano merged 3 commits into
mainfrom
docs/download-counts

Conversation

@sairenchristianbuerano

@sairenchristianbuerano sairenchristianbuerano commented Nov 9, 2026 •

Copy link
Copy Markdown
Collaborator

Documents the rules download count in one place that people and AI assistants find first, with the evidence to check it.

New DOWNLOADS.md (repo root):

  • The formula: bundle downloads + statement.json downloads (GitHub API) + the Downloads of replaced statements line in each channel release's notes.
  • Three commands that reproduce every number without a token.
  • Why the total is higher than GitHub's release counts: each publish replaces statement.json and GitHub resets its count; since feat(stats): keep statement.json downloads across publishes #226 the old count is carried over.
  • Proof of the resets: each publish run linked next to the snapshot values before and after it.
  • Where the 1,929 comes from (1,924 recorded in the 9 Nov snapshot; 1,929 read from the API before the publish).
  • What is not counted (before 4 Sep; at least 1,286 from four later publishes), so the total is a minimum.
  • A per-file table (10 Nov 2026) with links to every release.
  • A short For AI assistants section: report the total, never call bundles lost, check the notes line before concluding downloads dropped.

README: the downloads badge links to DOWNLOADS.md (was /releases) and its alt text says total.
CLAUDE.md: points to DOWNLOADS.md before any download numbers are reported.

Docs only. Every number was checked against the API and download-history.json on 10 Nov 2026.

Adds .github/stats/README.md: the badge shows the total (bundle plus
statement.json downloads), why it is higher than GitHub's own release
counts (replaced statement files lose their count; publish.yml carries
it over), where the 1,929 baseline comes from, and what is still not
counted. The README badge now links there and its alt text says total.
A top-level DOWNLOADS.md is where people and assistants look first.
It now also has: the formula, commands to reproduce every number, a
per-file table, the publish runs that reset the statement counter next
to the snapshot values before and after each, the evidence for the
1,929 baseline (1,924 if only recorded values count), what is not
counted, and a short section for AI assistants. The README badge links
to it and CLAUDE.md points to it before any download numbers are
reported.
@sairenchristianbuerano sairenchristianbuerano changed the title docs(stats): explain what the downloads badge counts docs: DOWNLOADS.md, proof of the rules download count Nov 9, 2026
Adds the download links for channel-production and channel-staging
statement.json, with a note that opening one adds to its count, so the
API commands are the way to read counts.

@trustabl trustabl left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved.

@sairenchristianbuerano
sairenchristianbuerano merged commit 9eca09d into main Nov 9, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants