Define inclusive guidelines

We want our guides to be as inclusive as possible, with language that translates to screen readers well.

Decision was made to use the following formatting (Bold, Quotes and Itallics):

Text or buttons that should be clicked/selected (e.g., Sign-In)
- Choose the Confirm button.
Text that the user enters word-for-word (e.g., user is instructed to enter xyz into this field)
- Enter "/Remind" into the field
Text that refers to something on the page
- Their name and email will appear in the Waiting to be Confirmed header.

Wording choices examples

Original: click on
- Head to 1password.com/ and click on Sign In on the top-right hand side. Choose the Hack for LA account. Sign in to the account using your credentials.
Proposed change:
- Head to 1password.com/ and choose Sign in. [insert screenshot here]
Original: right-hand side
- Step 2: Navigate to Vaults
  On the right-hand side of 1Password, click on Vaults.
Proposed change:
- Choose Vaults from the navigation panel.
Original: click on
- Search vault for the appropriate project title, and click on the project name link. For this example we will be using 100 Automations.
Proposed: indicates where they should search and separates concerns
- Use the Search Vaults input box to find the appropriate project title. For this example, we will be using 100 Automations, you will be searching for the name of your project.
  [insert screenshot]
- select the name of your project.
  [insert screenshot]

Original: user should see

walk you through should be replaced with take you
copy and paste the message below can be replaced with You can use the message below
next to their name can be replaced with for their name
disappears from the page can be replaced with closes
will appear can be replace with will be in

"Follow the steps listed below" should be replaced to "use the steps that follow"

Navigation Menu