Embed Size (px)
Citation preview
Who consumes it?
General public
Internal to the company
Developers
Determine the level of detail
It has to make sense!
Read it out loud
Use other resources
Spelling & Grammar Is Important
Spelling & Grammar Is Important
.Net Developers Like To
Capitalize Every Single
Word When Writing Text.
Be Specific When Needed
“First and last name required.”
“Email aliases cannot be created for users
without a first and last name. Please add
a first and last name for this user.”
Be Specific When Needed
“Phone numbers may only contain integers,
spaces, dashes, and parentheses.”
“This doesn’t look like a valid phone
number. Please enter phone numbers like
this: (123) 456-7890”
(but not too much information)
Highlight Important Details
Use Contrast or emphasis!
[email protected] was added to the Sales group.
Plural vs. Singular wording
1 user(s) were added.
You can’t count??
Choices
Choices
Choices
Error ending slideshow about errors
