Commit 67346574 authored by Diana Logan's avatar Diana Logan

Merge branch 'sselhorn-master-patch-84506' into 'master'

Image guidance recommends real-world scenarios

See merge request gitlab-org/gitlab!70226
parents e98fa078 4b7b3c37
......@@ -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