Team invitation TOFU email incorrect or unclear
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:
- I invite Sarah with:
keybase team add-member treehouse --email=sarah@treehouse.com --role=writer - An email message with the following instructions soon arrives to sarah@treehouse.com
- 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"
- After installing Keybase on her Ubuntu computer, she then proceeds to step 2 in the email: "2. Run the following command from your terminal:"
- 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
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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