Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Mistaken instructions for manually installing the macOS binary.

Open
#96 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
38/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Tech stack
shell

Research direction

Open contents/mac/create_bin_folder.tw2 around line 41 and review how the macOS binary is unpacked for each architecture. Update the manual-install instructions so the binary is found in its extracted directory without relying on an unsafe ambiguous path, then reread the walkthrough to confirm the steps work for both architectures.

Written by the indexing model from the issue text.

Description

https://github.com/exercism/interactive-cli-walkthrough/blob/53b89e180b72bd6e0df88769362104a08a40090c/contents/mac/create_bin_folder.tw2#L41 instructs the user to run

mv ~/Downloads/BINARY_NAME ~/bin

however, the binary is in the extracted directory ie. ~/Downloads/exercism*/BINARY_NAME.

I would submit a PR for this but I'm not sure how to make it dependant on the architecture because the extracted folder name is different depending on which architecture the user is on.

Another option is to change the instruction to

mv ~/Downloads/exercism*/BINARY_NAME ~/bin

but may not be desired because they may have another folder in there.

Dominant language
Ruby
Stars
13
Forks
24
Avg merge
17m
Merged PRs (30d)
1

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from exercism/interactive-cli-walkthrough

All issues in exercism/interactive-cli-walkthrough

Similar issues

More Ruby issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.