Should you add screenshots to documentation?

https://thisisimportant.net/posts/screenshots-in-documentation

Should you add screenshots to documentation?

This article discusses the advantages and disadvantages of using screenshots in documentation. Outdated screenshots can damage credibility, slow down page load times, replace explanations with visuals, and lack accessibility. However, screenshots can aid in scanning, provide visual context, and supplement confusing steps. The article suggests using simplified screenshots, making them accessible, and potentially automating their creation and maintenance.

Note

no. the answer is no. most of the time.

Published

2023

Summary

This article discusses the advantages and disadvantages of using screenshots in documentation. Outdated screenshots can damage credibility, slow down page load times, replace explanations with visuals, and lack accessibility. However, screenshots can aid in scanning, provide visual context, and supplement confusing steps. The article suggests using simplified screenshots, making them accessible, and potentially automating their creation and maintenance.