Skip to content

docs: point the macOS download at /releases, not /releases/latest#271

Merged
haowei2000 merged 1 commit into
developfrom
fix/macos-download-link
Jul 19, 2026
Merged

docs: point the macOS download at /releases, not /releases/latest#271
haowei2000 merged 1 commit into
developfrom
fix/macos-download-link

Conversation

@haowei2000

Copy link
Copy Markdown
Collaborator

Follow-up to #267 — the download links it added resolve to the wrong release.

The bug

GitHub's /releases/latest skips pre-releases, and the desktop builds are published as pre-releases (unsigned, not notarized — see release-desktop.yml). So the redirect lands on the connector:

$ curl -s -o /dev/null -w '%{redirect_url}\n' https://github.com/ElePerson/Cheers/releases/latest
https://github.com/ElePerson/Cheers/releases/tag/connector-v0.1.28

Every "Download for macOS" entry added in #267 pointed there — a user clicking the freshly-promoted download button in the README header or the landing-page hero would have landed on a connector release with no .dmg in sight.

The fix

Point them at the releases list (/releases) and say which tag to pick, since that page interleaves connector-v* and desktop-v* builds:

  • README.md / README.zh-CN.md — "Get Cheers" table row and the native-clients section.
  • website/index.html / index.zh-CN.html — hero CTA button and the macOS card in #clients.

Left alone on purpose: the connector install snippets in website/connector*.html use /releases/latest/download/…. Connector releases are not pre-releases, so that redirect resolves correctly for them.

Verification

Rendered both landing pages locally: no a[href*="releases/latest"] remains, both download links resolve to /releases, the macOS card grew by one line without breaking the 2×2 grid (rows stay equal-height at 304/280 px, no horizontal overflow).

Context

This surfaced while tagging desktop-v0.1.1, which is now published with the four desktop fixes that desktop-v0.1.0 was missing.

🤖 Generated with Claude Code

GitHub's /releases/latest skips pre-releases, and the desktop builds are
published as pre-releases (unsigned, no notarization). So the "latest"
redirect resolves to connector-v0.1.28 — the connector, not the desktop app:

  $ curl -o /dev/null -w '%{redirect_url}' .../releases/latest
  https://github.com/ElePerson/Cheers/releases/tag/connector-v0.1.28

Every download entry added in #267 pointed there. Send them to the releases
list instead, and say which tag to pick, since that page interleaves
connector-v* and desktop-v* builds.

The connector install snippets in website/connector*.html keep using
/releases/latest/download/… — the connector releases are not pre-releases,
so that redirect resolves correctly for them.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@haowei2000
haowei2000 merged commit a1457c9 into develop Jul 19, 2026
12 checks 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.

1 participant