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.