Reassess against Repository Quality Standard v1.6.0 - #35
Merged
Merged
Conversation
P08 moves from partial to pass. Nothing in this repository was relaxed to get there; the standard's badge rule was corrected in v1.6.0 and the criterion is now assessable. v1.5.1 asked for badge images "served from the repository or a first-party source where practical". That names no condition a repository can satisfy, so P08 sat at partial with no work available that would clear it. The v1.5.1 assessment also gave a wrong reason for preferring first-party images: it claimed img.shields.io observes every reader. Markdown rendered on github.com loads external images through GitHub's proxy, so the host sees the proxy and not the reader. That argument was carried over from W07, where it does hold, because a published site fetches images directly into the visitor's browser. Badges appear only in the README, so it did not apply there. v1.6.0 turns the rule on how a value changes: an image may be committed only when a repository event regenerates it, and a value that moves on its own is served live. Against that rule every badge here passes. CI already uses GitHub's workflow badge endpoint, the first-party live image the standard names. Conformance is committed and regenerated from the record. Licence, platform, and release have no first-party image source and are served live, which v1.6.0 records as a pass. Both readings of the new committing rule were checked before recording pass. "May be committed only when a repository event regenerates it" is a permission gate, not an obligation: it forbids committing a moving value rather than requiring a stable one to be committed. The reading under which licence and platform must become committed images makes "may" do the work of "must" and leaves a live third-party licence badge with no stated result at all. The v1.6.0 changelog settles it: no recorded result can turn into a fail from the change. Replace the "Remaining gap" section, which claimed P08 was the only criterion not at pass and pointed at trsdn/.github#31 as still open. Both are now false. The reasoning that justified the change is kept as a Badge hosting section rather than dropped, so a later reader can see the result moved because the rule moved. Badge regenerated from the record, not edited. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 58f30727-d91c-4464-a5bf-dff63fa9485f
trsdn
force-pushed
the
trsdn-reassess-standard-1-6-0
branch
from
August 31, 2026 16:45
915d261 to
fbe2daf
Compare
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
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.
Reassessment following
trsdn/.githubv1.6.0, which corrected the badge rule.P08: partial→pass. 74 pass · 0 partial · 0 fail · 19 n/a. State staysHealthy.This is the only result that changed, and it changed because the standard was corrected — not because anything here was relaxed. No file outside the record, its badge, and its evidence is touched.
Why it moved
v1.5.1 asked for badge images "served from the repository or a first-party source where practical". That names no condition a repository can satisfy, so
P08sat atpartialwith no work available that would clear it.The v1.5.1 assessment also gave a wrong reason for preferring first-party images: it claimed
img.shields.ioobserves every reader. Markdown rendered ongithub.comloads external images through GitHub's proxy, so the host sees the proxy, not the reader. I had carried that over from theW07argument for the published site, where it does hold because a browser fetches those images directly. Badges appear only in the README, so it never applied there.v1.6.0 turns the rule on how a value changes:
PassPassPass, preferred formPassPassThe reading I checked before recording
passThe sibling session asked me not to take their
passon trust, and the criterion does turn on a genuinely new distinction, so both readings were tested against the pinned text.The committing bullet reads "a badge image may be committed … only when a repository event regenerates it", naming licence, platform, and conformance as qualifying. That is a permission gate on committing, not an obligation to commit — it forbids committing a moving value, it does not require committing a stable one.
The competing reading, under which "everywhere else" excludes licence and platform so both must become committed images, makes "may" do the work of "must" and leaves a live third-party licence badge with no stated result at all. The v1.6.0 changelog settles it outright: "No recorded result can turn into a
Failfrom any of this."So licence and platform stay live. Committing generated images for them is permitted and would gain nothing: it trades a value correct by construction for one correct only until the next regeneration.
What remains is an availability and trust dependency on
img.shields.iofor three of five badges. Real, worth revisiting if a first-party source appears — but under v1.6.0 not a defect, and recorded as such rather than left as a vaguepartial.Changes
.github/conformance.yml—standard_version1.5.1→1.6.0,P08→pass..github/badges/conformance.svg— regenerated from the record with the v1.6.0 generator, not hand-edited. Label now readsv1.6.0 - Healthy.docs/self-assessment.md— header,P08row, and a new Badge hosting (P08) section recording why the result moved, so a later reader can see it followed a rule change. The old Remaining gap section is replaced by Open gaps: none — it claimedP08was the only criterion offpassand pointed attrsdn/.github#31as still open, both now false.Verification
conformance.py --checkagainst the v1.6.0 catalog:Healthy (na=19, pass=74), badge in sync.scripts/check-documentation.shgreen.The reusable conformance workflow checks out the standard at the tag named in the record, so CI now validates against
v1.6.0.