A developer at Arkio shares their practice of using 'release comics' — visual-first internal announcements combining before/after screenshots, annotations, and diagrams — to communicate code changes to teammates. The approach covers techniques like showing prior state for context, using multiple examples, annotating screenshots to clarify abstract concepts, and representing actions with arrows. The author argues visuals reduce cognitive load compared to text-only descriptions and translate well to other formats like live demos and design documents.
Table of contents
Prior stateShow, don’t tellUse multiple examplesAnnotations & illustrationsActionsOther mediumsFinal wordsSort: