Skip to content

Outputs ​

One run produces a folder like this:

clearer-error-messages-on-sign-up/
├── clearer-error-messages-on-sign-up.mp4
├── clearer-error-messages-on-sign-up-poster.png
├── clearer-error-messages-on-sign-up-preview.gif
├── images/01-summary.png  02-before-after.png  …
├── diagrams/sign-up-flow.svg  sign-up-flow.png
├── message.md
└── _source/

Video ​

  • 30 to 60 seconds, 90 at most, in four to seven scenes
  • 1920×1080, 30 fps, H.264, no audio track, ready to stream (faststart)
  • captions burned in: short lines that stay on screen long enough to read
  • re-encoded smaller when it would go over 25 MB, so it fits in an email
  • a poster image and a GIF preview for chat apps

Slides ​

Three to five PNGs at 3840×2160. The first one, 01-summary.png, works on its own: title, three points, a screenshot or a before and after, and what the client needs to do.

Summary slide

Diagrams ​

One to three Mermaid diagrams: a flowchart of the user's path, a sequence of what happens behind the scenes, a status lifecycle, a before and after journey or a rollout timeline. Labels are in the client's language with no code names. You get an SVG with the fonts embedded, a PNG, and the .mmd source to edit later.

Diagram slide

Message ​

A short message in the client's language: a subject line, two to four sentences, what's new, what they need to do (often nothing) and the list of attachments. [Customer name] and [Your name] stay as placeholders for you to fill in.