Skip to content

docs: clarify which macOS download to grab (fixes #335)#523

Open
lacymorrow wants to merge 1 commit into
mainfrom
LAC-1638/mac-download-guidance
Open

docs: clarify which macOS download to grab (fixes #335)#523
lacymorrow wants to merge 1 commit into
mainfrom
LAC-1638/mac-download-guidance

Conversation

@lacymorrow

Copy link
Copy Markdown
Owner

Summary

Users on macOS regularly ask which file to download from the releases page — the previous README section just said "pick the dmg for your architecture" without telling them how to figure out their architecture or that a universal.dmg exists.

This PR expands the macOS section of the README with:

  • A small table mapping each .dmg variant to when to use it (universal.dmg as the safe default, arm64.dmg for Apple Silicon, x64.dmg for Intel)
  • Guidance on how to check the chip (Apple menu ▸ About This Mac)
  • A note that the .zip files are the same app in a different container

Fixes #335.
Paperclip: LAC-1638

Test plan

  • README renders correctly on GitHub (markdown table preview)
  • Reviewer confirms wording matches how they'd answer the question in Discussions

The releases page lists universal, arm64, and x64 variants for macOS
without much context, so users on macOS often don't know which file
they need. Add a small table to the README's macOS section:

- universal.dmg (works on any Mac) as the safe default
- arm64.dmg for Apple Silicon
- x64.dmg for Intel

Also point at Apple menu > About This Mac for identifying the chip,
and note the .zip files are the same app in a different container.
@gemini-code-assist

Copy link
Copy Markdown

Warning

Gemini encountered an error creating the review. You can try again by commenting /gemini review.

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.

How do I know which one to download with Mac? [ISSUE]

1 participant