Screenshot or Step Text?
Choose the review move that keeps a how-to guide task-complete without making the screenshot the source of truth.
Docs PR review: the screenshot is carrying the instruction. Lina needs to leave one review comment before the admin setup guide merges. What should she ask for? Ask the author to put the menu path and required choices in the step text, then keep the screenshot as orientation. Right. The how-to step becomes searchable, translatable, reviewable, and accessible. The image still helps recognition, but it is no longer the source of truth. Approve it because screenshots are clearer than prose when the UI is complex. Weaker. This violates minimalism by making the reader decode a visual for a task-critical fact.…
Sign up free: one personalized lesson every day, matched to your role and goals.
Already have an account? Sign in