keybase / keybase/keybase-issues

Add per-platform instructions? First-run setup could use a lot of UX improvement

Open
#776 2 comments 0 reactions 0 assignees View on GitHub
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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.