Quick answer
For Docs and tutorial screenshots, follow a checklist: backup, format, size/quality, output, spot-check. Docs screenshots need readability/searchability; prefer PNG/WebP and cap width.
Why it matters
A fixed checklist prevents skipping the critical step.
A consistent width looks cleaner.
Step by step
- Crop sidebars, empty space and unrelated windows first.
- Prefer PNG/WebP for text; use JPEG around 85% for photo-like screenshots.
- Export at the actual display width instead of uploading a 4K screenshot.
- Zoom in after compressing to check text/UI edges.
- Keep the original; use the compressed copy only for publishing.
Common mistakes
- Compressing code screenshots to 50% JPEG and blurring text.
- Uploading a 4K screenshot displayed only 800px wide.
- Recompressing and dirtying the edges.
- Converting transparent UI to JPEG, turning the background white/black.
Checklist
- Sensitive areas cropped/masked.
- Text screenshot not saved as low-quality JPEG.
- Dimensions match the actual display width.
- Zoomed in on the target page.
- Original kept.
Key facts
- A consistent width looks cleaner.
- Readers may zoom in for UI details.
FAQ
What is a Docs and tutorial screenshots checklist?
For Docs and tutorial screenshots, follow a checklist: backup, format, size/quality, output, spot-check. Docs screenshots need readability/searchability; prefer PNG/WebP and cap width.
How long does it take?
Usually 1-3 minutes; for intermittent issues, run 30 seconds and retest elsewhere.
Is data uploaded?
Runs locally and does not upload video/audio; extensions may still read the page.
Source: Web.dev images