release: make macOS downloads obvious #28

Open
opened 2026-06-04 21:16:59 +00:00 by KofTwentyTwo · 0 comments
KofTwentyTwo commented 2026-06-04 21:16:59 +00:00 (Migrated from github.com)

Problem

The v0.3.0 release includes macOS binaries, but the assets use Go platform names:

  • license-tool_0.3.0_darwin_amd64.tar.gz for Intel Macs
  • license-tool_0.3.0_darwin_arm64.tar.gz for Apple Silicon Macs

Users scanning the GitHub Release assets may not know that darwin means macOS. The Homebrew cask is probably the best macOS install path, but that is separate from the asset list and easy to miss.

Current State

  • GitHub Release assets include macOS, Linux, Windows, and checksums.
  • Homebrew cask install works via brew install --cask KofTwentyTwo/tap/license-tool.
  • The published release notes now include the Homebrew command.

Acceptance Criteria

  • Make the macOS download path obvious in release-facing docs.
  • Explicitly map darwin_amd64 to Intel macOS and darwin_arm64 to Apple Silicon macOS.
  • Decide whether GoReleaser should keep Go-native darwin asset names or publish clearer macOS-named archives.
  • Document Homebrew as the recommended macOS install path, with direct GitHub assets as the fallback.
## Problem The v0.3.0 release includes macOS binaries, but the assets use Go platform names: - `license-tool_0.3.0_darwin_amd64.tar.gz` for Intel Macs - `license-tool_0.3.0_darwin_arm64.tar.gz` for Apple Silicon Macs Users scanning the GitHub Release assets may not know that `darwin` means macOS. The Homebrew cask is probably the best macOS install path, but that is separate from the asset list and easy to miss. ## Current State - GitHub Release assets include macOS, Linux, Windows, and checksums. - Homebrew cask install works via `brew install --cask KofTwentyTwo/tap/license-tool`. - The published release notes now include the Homebrew command. ## Acceptance Criteria - Make the macOS download path obvious in release-facing docs. - Explicitly map `darwin_amd64` to Intel macOS and `darwin_arm64` to Apple Silicon macOS. - Decide whether GoReleaser should keep Go-native `darwin` asset names or publish clearer macOS-named archives. - Document Homebrew as the recommended macOS install path, with direct GitHub assets as the fallback.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: KofTwentyTwo/license-tool#28