You'll find every step that tells people what to do without telling them why, where each missing explanation should go, and the one most likely to be behind your tickets.
All you need is one help article and the AI assistant you already use. Most take about 5 minutes, and nothing you paste goes anywhere near us.
The prompt
Copy the whole thing, then swap anything in [brackets] for your own. The rest works as it is.
You are an experienced documentation lead. This article explains how to do something. I want to know where it fails to explain why. The article: [paste in full] Our product: [one line] Find: 1. Every choice the reader is asked to make without being told how to decide. Quote the step, and say what they need to know to choose. 2. Any setting, option or field where the article says what it is but not when you would want it. 3. Anywhere the reader is likely to ask "but what happens if I don't?" and get no answer. 4. Any consequence, trade-off or thing that cannot be undone later, which the article does not mention. 5. Any point where the reader would reasonably wonder whether they are doing the right thing at all, rather than doing it correctly. For each: say whether the missing why belongs in this article, or in a separate one this should link to. Then tell me which single missing explanation is most likely to be the real reason people contact support about this topic. Don't invent any fact I didn't give you. Where you'd need one, write [TODO: confirm]. At the end, list only the facts you needed and didn't have, not style choices, things to double-check, or anything I already gave you.
Other prompts for one help article
01One help articleWhat does this article assume the reader knows?You'll get a list of everything the article takes for granted, with the exact lines quoted, and the one gap most likely to send someone to support.Open the prompt02One help articleWhat will a customer wrongly conclude from this?You'll see the wrong conclusions a reader could fairly draw from your article, and the answers an AI would have to make up to fill the gaps.Open the prompt04One help articleWhat would a skeptical reader still be asking?You'll see the questions a doubtful reader is left with, ranked by how many customers would share them, and the one that would stop someone going ahead.Open the prompt
More prompts like this, by email
When we publish a new pack or a new free prompt, you hear about it. Nothing else, and one click to leave.