Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 9a5e275

Browse files
authoredFeb 5, 2020
Update STYLEGUIDE.md
1 parent f97c385 commit 9a5e275

File tree

1 file changed

+0
-7
lines changed

1 file changed

+0
-7
lines changed
 

‎STYLEGUIDE.md

-7
Original file line numberDiff line numberDiff line change
@@ -123,13 +123,6 @@ When it comes to describing property values, be definitive in what is and is not
123123

124124
* Capitalize “Hooks.”
125125

126-
### Example
127-
128-
**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.
129-
130-
**Good** “Open **Xcode > Preferences...** and select the **Components** tab.” Path is clearer to pick out from the surrounding copy.
131-
132-
133126
## Empathize with readers
134127

135128
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!

0 commit comments

Comments
 (0)
Please sign in to comment.