The Asterly blog
How to write step-by-step guides and help articles that people (and AI assistants) can follow.
Stop Sending Support Videos: Reply With a Link to Steps Instead
How to send a customer step-by-step instructions instead of a video: numbered steps, one screenshot each, behind one link they can reuse.
How Many Screenshots Does a Help Article Need? One per Decision, Not One per Click
How many screenshots in a help article? One wherever the reader must find or choose something. A real 8-step test, trimmed to 3.
How Small IT Teams Document Procedures: Text First, Screenshots Where It Counts
How to document IT processes and procedures in a small team: text first, screenshots only where the screen matters, one owner and a date.
Release Notes Say What Changed. Help Articles Say How to Use It
How to convert release notes into help articles: keep only changes that alter what users do, title each as a task, write steps by doing it.
llms.txt for Help Centers: An Example File, Line by Line
What llms.txt for a help center looks like, with a labelled example file explained line by line, plus how to write and maintain your own.