keybase / keybase/client

Team invitation TOFU email incorrect or unclear

Open
#9,070 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Go
Stars
9.2k
Forks
1.3k
Avg merge
12h 58m
Merged PRs (30d)
56

Description

When inviting new members to a team they receive an email with incorrect instructions:

  1. I invite Sarah with: keybase team add-member treehouse --email=sarah@treehouse.com --role=writer
  2. An email message with the following instructions soon arrives to sarah@treehouse.com
  3. Sarah, who has never used Keybase before follows the instructions by starting on instruction 1: "1. install Keybase on your computer, if you haven't"
  4. After installing Keybase on her Ubuntu computer, she then proceeds to step 2 in the email: "2. Run the following command from your terminal:"
  5. She now gets the following message: " ▶️ ERROR Login required"

The problem is that nowhere in the instructions in the email or on the installation page or when she starts Keybase for the first time is she prompted to create or login with the step to create her account.

This is a UX bug that can be alleviated by adding a step between 1 and 2 in the email: "Create your account", or on the installation page (linked from the email) which after the installation steps prompts you to create an account or log in, or after run_keybase mention that the user may now create an account.

(By the way, the squirrel is a nice touch! :))

Contributor guide

No contributing guide indexed for this repository

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.

Research direction

Start by locating the team-invitation email instructions and reviewing the linked Ubuntu installation page and the run_keybase onboarding flow. Confirm where a new user is expected to create or log in to an account, then ensure the email makes that step explicit before the terminal command; verify the resulting instructions for a first-time invitee.

Written by the indexing model from the issue text.

Assessment

Tech stack
ubuntu
Domain
documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.