Skip to content

fix: release experience polish (badge reliability + updater heading)#85

Merged
RealZST merged 2 commits into
mainfrom
fix/release-polish
Jun 16, 2026
Merged

fix: release experience polish (badge reliability + updater heading)#85
RealZST merged 2 commits into
mainfrom
fix/release-polish

Conversation

@RealZST

@RealZST RealZST commented Jun 16, 2026

Copy link
Copy Markdown
Owner

Two small, independent release-experience fixes (one commit each).

1. fix(badges) β€” stop the README release/downloads badges from breaking

The github/v/release and github/downloads badges use shields.io's dynamic GitHub-API endpoints, which intermittently render as Unable to select next GitHub token from pool whenever shields' shared GitHub token pool is rate-limited. (The static /badge/... license & platform badges on the same line never fail β€” proof it's a shields-side issue, not ours.)

  • Release badge β†’ shields endpoint type, backed by a committed .github/badges/release.json. A new workflow (update-release-badge.yml) rewrites that JSON on release: published, so the badge never calls the GitHub API at render time.
  • Downloads badge β†’ cacheSeconds=86400, kept dynamic but far less exposed to the same failure.

Note: the endpoint badge only renders once release.json exists on main, i.e. after this PR merges.

2. fix(updater) β€” correct release-notes heading hierarchy

ChangelogMarkdown only overrode h2 (rendered small/gray) and let h3 fall through to the browser default (large/bold), inverting the hierarchy in the in-app updater dialog β€” top-level ## Highlights / ## What's Changed looked smaller than their ### Features / ### Fixes children. Now h2 is the prominent heading and h3 the subdued subheading.

Testing

  • npm run test β€” 231 passed; tsc --noEmit clean; biome check clean.
  • README/workflow/JSON validated (YAML + JSON parse OK).

πŸ€– Generated with Claude Code

RealZST and others added 2 commits June 16, 2026 22:01
…s badge

The README release and downloads badges use shields.io's dynamic GitHub-API
endpoints, which intermittently fail with "Unable to select next GitHub token
from pool" when shields' shared token pool is rate-limited (the static badges
on the same line never fail). Render the release badge via shields' endpoint
type backed by .github/badges/release.json, which a new workflow updates on
'release: published' β€” so it never calls the GitHub API at render time. Add
cacheSeconds=86400 to the downloads badge to cut its exposure to the same error.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
ChangelogMarkdown only overrode h2 (small/gray) and let h3 fall through to the
browser default (large/bold), inverting the heading hierarchy in the in-app
updater dialog β€” top-level ## sections looked smaller than their ### children.
Make h2 the prominent heading and h3 the subdued subheading.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@RealZST RealZST merged commit 65ecf1c into main Jun 16, 2026
3 checks passed
@RealZST RealZST deleted the fix/release-polish branch June 16, 2026 19:05
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