what makes a good message
Post on 13-Jul-2015
228 Views
Preview:
TRANSCRIPT
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!
User@domain.com was added to the Sales group.
Plural vs. Singular wording
1 user(s) were added.
You can’t count??
Plural vs. Singular wording
user@domain.com has been added
3 users have been added
Choices
Choices
Choices
Error ending slideshow about errors
top related