Writing guides

Good guides are short, concrete, and in everyday language — the way you'd explain it to a neighbour.

 

Write warnings first, then the steps. One thought per line, start with a verb. Only what's needed — no brochure.

 

When editing, you assemble a guide from blocks: paragraph, step, warning, and divider. In a paragraph you can make text bold or italic and add links.

 

---

 

Here's what a section can look like (example from “Starting the band saw”):

 

 

---

 

Plain text works well for background or “Why do we do it this way?”

 

If you take responsibility for a guide, you maintain it — others can leave suggestions: What could make this guide even better?