keybase / keybase/keybase-issues

Missing clear message and understandable documentation

Open
#718 1 comment 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

If keybase is, what I heard about it in re.publica talk or read in Germans biggest IT-magazing (CT from heise) Congratulations, i love you guys! But as you asked for feedback, it seems pretty much too nerdy to get momentum yet. First about your slogan:
"Keybase will be a public directory of publicly auditable public keys. All paired, for convenience, with unique usernames." Why no just something more simple like: "Keybase is a better/smart way to prove identity for secure comunication over internet."
Not sure, why you first ask for private key, but private and uploading to the web does not got well together even for non security-experts. So I got stucked with command line option, installed required programs on windows, but pretty much missed the steps to get into command line and prove my twitter or github. Would be awesome to have a video for that! (Also good promotion to be there!). Good luck!

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reviewing the issue's feedback about the slogan, private-key explanation, and Windows command-line onboarding for proving Twitter or GitHub accounts. No files or tests are named; done would mean clearer introductory documentation and understandable steps, with the requested video addressed if it remains in scope.

Written by the indexing model from the issue text.

Assessment

Domain
cli, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.