So often, the problem with Knowledge Bases is that they are hard to understand. Either the knowledge articles do contain the knowledge and it's just not communicated that well, or the Knowledge base is hard to coordinate. So what do you do?
Good length for a Knowledge Base article
No one wants to read a 50 page manual. Make sure your knowledge base ariticles are as short and to the point as you can make them. A good rule of thumb is that the article should fit "above the fold". That is to say, you should never have to scroll to read the article.
But be pragmatic - if you need to fit more information, you should. And if everything you need to say is best summarised in three sentences, then let the whole article be three sentences.
Focus on the context of the query
We always recommend speaking the language of your end users instead of industry jargon as much as possible. It helps them navigate Self-Service Portals better, and it makes sure they feel like you and them are on the same page. Similarly, it helps them understand your knowledge base aricles easier.
The important thing to understand here is you should focus on a solution to the context of the users situation - not error codes and how to deal with them. Phrase the problem in a way the user understands "Printer is not working" rather than "printer shows error code 330219". Bring in technical things like error codes and serial numbers only if you definitely need to.
Make sure your users find the Knowledge Base articles
And along the same lines - make sure your users can find your knowledge articles. A great thing to do, especially if you have a search funcionality in your knowledge base, is to phrase your articles as questions. This is because people tend to phrase their queries (for example on Google) as questions when they want to find something out. It's a fun human quirk in how we interact with technology, but one you can put to good use!
Put yourself in the shoes of a user who has the specific problem of what you are writing a knowledge base article for. How would they phrase the question? What keywords would they use? Maybe they would just type "I cannot log in" - then title your Knowledge Base article that. If you have access to search history data in your knowledge base, you can have even have a look and see what the most common phrasings of a certain query are - and how often it crops up.
Consider different levels of experience
One good thing to do is to also let your users know what is required from them to solve a problem themself. A way to do this is to have an indicator at the top of the page that tells the reader how in depth the procedure is. This could be either a numerical 1-5 type value, or a plain text "intermediate" or "easy".
These types of indicators are also useful if you need to write a lot of instructions but they aren't actually that complicated. It can encourage people who are faced with a "wall-of-text" to actually engage with it if they are reassured that the information is not as complicated as it may look at first glance.
Becoming a Better Service Manager
Looking to bring your Services Delivery up a level? Try our E-book on Best Practice Service Management.