All packs

Free · Checklist · 5 pages · 27 checks

Is this help article ready to publish?

27 checks in plain language. If you can't tick one, that's your next fix.

After using this: You'll know before you publish whether the article is ready, and exactly what to fix if it isn't.

Who this is for

You're about to publish something and you'd rather catch the problems yourself than hear about them from a customer.

Not for you if

You want the method for writing the article, not a check at the end. That's Write help articles humans and AI can use.

Free

Free. Enter your email and we'll send you both files.

How it works

Open the checklist next to your finished draft and work down the list. Tick what passes. Any box you can't tick is your next fix. When everything is ticked, publish.

What's inside

  1. 01Which check do you need? A shorter routine of 12 checks for small edits
  2. 02Does the answer come first?
  3. 03Can the reader follow it?
  4. 04Is anything missing?
  5. 05Is it clear and consistent?
  6. 06Will people find it?
  7. 07Can an AI assistant answer from it?
  8. 08Did you test it like a reader?
  9. 09The short version: every group in one line

See the pages

A page from the PDF you download, as it is. Select it for a closer look.

Look inside

A sample from inside, so you can see what you're getting.

Does the answer come first? People arrive with a question, so answer it before anything else. [ ] The title says exactly what the article covers, in the words your customer would search. Check it against the words they use in tickets. [ ] The opening gives the answer or main outcome first, before any background. [ ] Who the article is for, and any condition on the whole page such as a plan, a role or a limit, is in the intro section of the article (the part above the first heading), never left for the end. This is 1 of 7 groups, 27 checks in all, in the full checklist.

The thinking behind it

Want the thinking behind this resource? The paid course Writing the article covers it in short parts, with an exercise in each.

Questions

Yours, free

Enter your email and we'll send you both files.