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 copy the shape of 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 is useful when it lets the reader predict the next step, not when it decorates the page.