Visual explanation

A good explanation answers one question with one picture the reader can check against the code. Prose carries the reasoning, and the visual carries the shape: what happens in what order, what calls what, what lives where. Each visual stands next to the sentence that tells the reader what to look for.

1. Name the question

Write the question in one sentence, in the reader's words: "What happens between parseMarkdown and the HTML?" If it's two questions, answer the one they asked and offer the other.

Done when the question fits on one line.

2. Pick the view

Choose by the shape of the answer: