Resources
Notes on explaining things clearly.
Practical reading for anyone who writes step-by-step guides, help articles or internal procedures.
Blog
Advice on writing guides people can follow: when to send steps instead of a recording, how many screenshots a help article needs, documenting IT procedures, turning release notes into help articles and writing an llms.txt file.
- Stop Sending Support Videos: Reply With a Link to Steps Instead
- How Many Screenshots Does a Help Article Need? One per Decision, Not One per Click
- How Small IT Teams Document Procedures: Text First, Screenshots Where It Counts
- Release Notes Say What Changed. Help Articles Say How to Use It
- llms.txt for Help Centers: An Example File, Line by Line
The History of Guides
Coming soon
A longer piece we haven’t written yet. It will appear here when it’s ready.