TLDR · MISCELLANEOUS

SHOULD YOU ADD SCREENSHOTS TO DOCUMENTATION?

thisisimportant.net6 min read

Summary from the TLDR newsletter

This article looks at the advantages and disadvantages to adding screenshots to documentation and provides guidelines for using screenshots in documentation. Screenshots in documentation can be bad as outdated screenshots can cause customers to lose trust in the documentation accuracy, they make pages load more slowly, they make the documentation less accessible, and using them can cause writers to produce lower-quality instructions. However, they can be useful as they make it easier to find relevant parts of the content, provide a visual frame of reference for readers, and can supplement confusing task steps.