keybase / keybase/keybase-issues
Add per-platform instructions? First-run setup could use a lot of UX improvement
- Dominant language
- No language data
- Stars
- 899
- Forks
- 40
- PR merge metrics
- No merged PRs in 30d
Description
I found the first-run setup of Keybase to be insanely complicated. I'm very well-versed in working in the command-line, I've got a working `homebrew` install, an up-to-date `npm` install, etc etc… but I still found several points in the installation instructions where I had to simply figure out how to accomplish something Keybase needed set up.
To be fair, I think a lot of this is platform-specific, but if we want to have Keybase be fairly turn-key to setup, a good per-platform installation guide is key. (Think: links and one-liners for installing things like `homebrew` (needed to get `gpg` installed), etc.)
I'll update this issue with notes from a meeting about Keybase I'm having with a couple of friends this weekend.
Contributor guide
No contributing guide indexed for this repository
Research direction
Review the existing first-run installation instructions and identify the platform-specific setup steps mentioned in the issue, including Homebrew, gpg, and npm prerequisites. Done means providing clear per-platform installation guidance with relevant links and one-liners; the issue names no files or tests to run.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 30/100