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.
Writing filed under Learning Lab.
A good tutorial shows the mistake the reader is about to make and gives them a way back.
Stable notation and repeated small examples do more for intuition than a tour through every formula.
Readers build their mental model from the first runnable example, so that example has to be honest.
Running Python in the page changes a tutorial from explanation into a small lab.
A diagram helps when it lets the learner predict the next step, not when it decorates the page.