Skip to content

Commit

Permalink
Update STYLEGUIDE.md
Browse files Browse the repository at this point in the history
  • Loading branch information
rachelnabors authored Feb 5, 2020
1 parent f97c385 commit 9a5e275
Showing 1 changed file with 0 additions and 7 deletions.
7 changes: 0 additions & 7 deletions STYLEGUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,13 +123,6 @@ When it comes to describing property values, be definitive in what is and is not

* Capitalize “Hooks.”

### Example

**Bad** “Open Xcode’s ‘Preferences...’ menu and then click on ‘Components.’” Ambiguous. Relies on reader knowing that “Preferences” is a submenu of “Xcode.” Difficult to read at a glance.

**Good** “Open **Xcode > Preferences...** and select the **Components** tab.” Path is clearer to pick out from the surrounding copy.


## Empathize with readers

When writing step-by-step instructions (e.g. how to install something), try to forget everything you know about the topic to attain a "beginner's mindset." Imagine follow the instructions you write, one step at time. Often you will discover that there is implicit knowledge that you forgot to mention, or that there are missing or out-of-order steps in the instructions. UX research pro tip: ask _someone else_ to follow your instructions and see where they get stuck!
Expand Down

0 comments on commit 9a5e275

Please sign in to comment.