Technical writing needs room for wrong guesses
A good tutorial shows the mistake the reader is about to make and gives them a way back.
#teaching
Posts tagged with teaching.
The first example carries too much weight
Readers build their mental model from the first runnable example, so that example has to be honest.
Pyodide makes blog posts feel less theoretical
Running Python in the page changes a tutorial from explanation into a small lab.
Visual examples should earn their space
A diagram helps when it lets the learner predict the next step, not when it decorates the page.