Skip to content

Finish including #61: the authority for the count, and where it is findable (1.28.2) - #94

Merged
trsdn merged 1 commit into
mainfrom
downloads-badge-placement
Sep 25, 2026
Merged

trsdn merged 1 commit into
mainfrom
downloads-badge-placement

Conversation

@trsdn

@trsdn trsdn commented Sep 25, 2026

Copy link
Copy Markdown
Owner

#93 moved #61 into REC-02 and carried its substance. Re-reading the original diff against what landed, two things did not survive the move.

The authority for the count. #61 said to "use the release assets as the authority". That matters: a download figure can come from several places and they disagree — a package registry counts installs, a mirror counts its own traffic, and neither is what a release badge claims to show. REC-02 now says it.

Where it is findable. #61 put this beside the badge rules, where somebody deciding what badges to show is already reading. REC-02 put it in the recommendations table, where a reader has to already know it exists. Status Badges now points at it and answers the question that section would otherwise raise:

A repository that publishes downloadable release assets may also show a live total-download count. That badge is REC-02 and not part of the block this criterion requires, so it adds no condition to P08 and its absence is not a gap.

Version

Patch. A recommendation produces no result, and a cross-reference changes none either.

Validation

standard.py --check, conformance.py --check, links.py, 159 tests, markdownlint — all green.

…ndable

Moving #61 into REC-02 carried its substance and dropped two things worth
keeping.

The first is a phrase: the original said to use the release assets as the
authority for the count. That matters, because a download figure can come from
several places and they disagree — a package registry counts installs, a mirror
counts its own traffic, and neither is what a release badge claims to show.

The second is placement. #61 put this beside the badge rules, where somebody
deciding what badges to show is already reading. REC-02 put it in the
recommendations table, where somebody has to already know it exists. Status
Badges now points at it and says plainly that it adds no condition to P08 and
that its absence is not a gap, which is the question a reader of that section
would otherwise have to go and answer elsewhere.

Patch: a recommendation produces no result, and a cross-reference changes none
either.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: f34e4f0b-ebd2-4432-9c55-9851a5e58c50
@trsdn
trsdn merged commit 91e111b into main Sep 25, 2026
11 checks passed
@trsdn
trsdn deleted the downloads-badge-placement branch September 25, 2026 08:25
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.

1 participant