boxorandyos

Client support portal

How to write a clear knowledgebase article

PURPOSE A clear knowledgebase article helps users solve a problem or complete a task without extra help. STRUCTURE Use a clear title, audience, purpose, prerequisites, steps, troubleshooting notes, and escalation guidance. WRITE FOR SEARCH Use the words users are likely to search for, including common terms and error phrases. KEEP IT FOCUSED One article should answer one main question or task. BEST PRACTICE If the article tries to solve everything, it usually solves nothing.

← Back to knowledge base