Kit · 34 pages · 11 prompts + house style
Shape your help center
Decide where one article ends and the next begins, before you write 40 that overlap.
After using this: You'll know which articles to write, how long each one should be, and what to do when the same task has 6 slightly different answers.
You keep having the same argument with your team about where something should live, and you keep ending up with articles that overlap.
You want help writing the article itself. That's Write help articles humans and AI can use.
How it works
Split or merge is the oldest argument in documentation, and it used to come down to whoever felt strongest about it. It doesn't anymore. A retrieval system (the search step behind an AI answer) cuts your articles into pieces, often along your headings, and hands a few of them to an AI, so where you put a boundary now decides what a customer's AI sees and what it never sees. This kit is the decisions that come before writing: how many articles a topic needs, how long each one should be, and what to do when the same task works 6 different ways depending on the platform.
What's inside
- 01Your structure is now 2 structures: what changes when an AI reads your help center
- 02Where one article ends and the next begins: when to split and when to merge
- 03How long an article should be
- 04Procedures that got complicated: breaking up a 30-step procedure, and when a series is the right call
- 05One procedure, several variants: 3 patterns, and how to choose in about 30 seconds
- 06Hubs, overviews and the getting started trap
- 07Categories and the names on them
- 0811 prompts, from mapping the structure you have to testing it like a retriever, with a worked example of the structure map
- 09Telling whether it worked
- 10Your structural house rules, as a setup prompt for your AI
- 11The short version: the house rules and the prompts on one page
See the pages
3 pages from the PDF you download, as they are. Select one for a closer look.
Preview a prompt from the pack
The full prompt, exactly as it appears in the pack. Nothing removed.
The thinking behind it
Want the thinking behind this kit? The course Deciding what goes where covers it in short parts, with an exercise in each.
Questions
Shape your help center, $89
Instant delivery after payment.