Should you add screenshots to documentation?

Should you add screenshots to documentation?

12/10/2024

notes

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

link

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

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.

tags

screenshots ꞏ documentation ꞏ accessibility ꞏ technical writing ꞏ UI ꞏ user experience ꞏ SaaS ꞏ image optimization ꞏ alt text