Commit 4b7b3c37 authored by Suzanne Selhorn's avatar Suzanne Selhorn Committed by Diana Logan

Image guidance recommends real-world scenarios

parent e1076b8f
......@@ -1081,10 +1081,15 @@ To select your avatar:
## Images
Images, including screenshots, can help a reader better understand a concept.
However, they can be hard to maintain, and should be used sparingly.
However, they should be used sparingly because:
Before including an image in the documentation, ensure it provides value to the
reader.
- They tend to become out-of-date.
- They are difficult and expensive to localize.
- They cannot be read by screen readers.
If you do include an image in the documentation, ensure it provides value.
Don't use `lorem ipsum` text. Try to replicate how the feature would be
used in a real-world scenario, and [use realistic text](#fake-user-information).
### Capture the image
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment