When writing a help article with the title "{Your Product} Glossary", some of the most important things to consider are:
- Defining each term clearly and concisely, using simple language that is easy to understand.
- Providing examples or explanations to help users better understand the meaning and context of each term.
- Organizing the terms alphabetically or by category to make it easy for users to find the information they need.
- Including links to other relevant articles or resources that provide more information on each term or its related concepts.
- Regularly updating the glossary to ensure that it remains accurate and up-to-date.
Overall, the goal of a product glossary should be to provide users with a comprehensive and easy-to-use reference guide for the technical terms and concepts used in the product.
๐ย Top five tips to write a great help article
A well-written help article should be clear, concise, and easy to understand. It should provide step-by-step instructions or guidance on how to use the service or solve a specific problem.
Here are the top five key elements that a good help article should include:
- A clear and concise title that accurately describes the content of the article
- An introduction that explains the purpose of the article and provides some background information on the topic
- Step-by-step instructions or guidance on how to use the service or solve a specific problem Screenshots, images, or videos that illustrate the steps or concepts being discussed
- Links to related articles or resources for further reading or support
- Make the content easy to skim by using appropriate headers. No one wants to be intimidated by a wall of text.
Overall, the goal of a good help article for a SaaS is to provide users with the information and support they need to effectively use the service and achieve their goals.
Curious to learn more about creating the perfect help center? Check out HelpKitโs Help Center Academy ๐

๐ Curious about all the Notion blocks you can use with HelpKit?
Check out our test suite here.
