Knowledge Base Articles: Types, Creating, and Examples of KB Articles
![ClickHelp Team](https://clickhelp.com/wp-content/uploads/2024/04/ClickHelp-Logo-Logo-only-Full-color-no-space@2x.png)
Our modern world is so submerged in good products that such products don’t guarantee success. Loyal customers, on the other hand, can lend eclat to business. So the first thing to do to make customers happy is to have top-rank customer support. Not just for cases when a customer has troubles with a product but also to help customers make the most of a product. Great support helps to retain more customers. And knowledge base articles are an efficient way to improve your customer support.
A knowledge base (KB) is a brilliant source of information for users. That is an excellent repository – store, share, and organize the information the way you want and need. You can build it for both external (customers) and internal users (employees). If we talk about customers, it is vital to show them that you are ready to interact with them not only at the beginning of their journey with your product but all the way long. In case of internal users, you act for the sake of your workflow – to teach your employees how to work most effectively and reduce mistakes.
A knowledge base comes in many shapes and sizes. But the main two types known are internal and external knowledge bases.
An internal knowledge base prioritizes serving the company and the employees, and an external knowledge base is commonly created for the convenience of product users.
Since external knowledge bases are for customers, the content differs greatly from those on internal knowledge bases.
As for the knowledge base articles – there are many types of those:
Each one of them demands its own unique structure and approach.
The basic reasons to create a KB are the following:
You can check out the following post to get deeper into the theme – Guest Blog: TOP 7 Reasons to Create an Online Knowledge Base.
In fact, building a KB is not a super difficult task. Anyone can do it if they have the right tools. It depends on the company, but most often a technical writer is responsible for that. The main idea is to collect the most frequently asked questions and to write short but informative articles aimed at solving specific problems. You can ask not only the support team about the hot questions but also the sales managers, or you can check professional communities to learn about the users’ pains.
What you should pay attention to while creating a knowledge base to make it informative and efficient:
Tastes differ. Some companies prefer to make their information public. Others prefer to limit access to their docs. It depends on their aims. On the one hand, public information can be easily found by potential customers. That contributes to the sales process. But, on the other hand, not only potential customers will use it – your competitors may do this as well. It makes sense to give access to particular types of customers. So, if you want to limit access to information, make sure your knowledge management tool can do it.
In this respect, the Single Sign-On (SSO) technology becomes crucial. With its help, you can solve the access problem: you can give users limited access to your KB, and they will see particular sections they are supposed to see. Moreover, the SSO technology provides a clear authorization process. Users authorized in your product will be automatically authorized in your documentation portal. Check out this post if you want to learn more – Software Documentation in the SaaS World.
One of the best ways to upgrade the creation of your support articles is to use a standardized set of templates. This will save time for technical writers and ensure that all your articles are consistent throughout the knowledge base. Every type of knowledge base article demands a certain template. Here are four template examples to help you with your KB:
Title: About (Feature Name)
Description: Brief description of the product or feature
Links: Anchor links to any topic within the more extensive informational article
Features:
Further reading: Links to related articles
Title: Frequently Asked Questions
Topic (if applicable): Brief description of the topic being covered
Table of contents:
Answers:
Further reading: Links to related articles
Title: How to (task name)
Task: Brief description of the task to be accomplished
Prerequisites (if applicable): Brief description of which products/features/customers the task applies to
Table of contents (if necessary)
Instructions:
Outcome: Brief description of what should be possible once the task is completed
Further reading: Links to related articles
Title: (what is a problem)
Problem: Brief description of the problem to be solved
Overview of possible solutions (if applicable)
Solutions:
Result: Brief description of how to confirm the problem is solved and what to do if it isn’t
Further reading: Links to related articles
To create an effective KB, one should carefully choose the knowledge management software. Your tool should allow you to create and publish content easily, make the review process clear, make the collaboration and teamwork smooth. One of the best solutions for building a knowledge base is using an online documentation platform like ClickHelp. It can offer you all the above-mentioned features and many more options to make your KB awesome.
Creating an informative knowledge base is not a big task if you have the right tool at hand. In a wide variety of tools, make sure you choose the most suitable one. Consider what type of information your users want to get and follow the tips described in this post to succeed in building your KB.
Good luck with your technical writing!
ClickHelp Team
Author, host and deliver documentation across platforms and devices
Get monthly digest on technical writing, UX and web design, overviews of useful free resources and much more.
"*" indicates required fields