Knowledge Base Articles: Tips, Tricks, and Templates

Sophie Danby August 22, 2022
- 16 min read

Knowledge management is the ITIL practice that increases service desk resolution rates, and improves technical skills and everyone’s experience. Done well, a shared knowledge base will help technical teams and end-users. In this sense, knowledge base articles are a great way to build a library that provides valuable insights into how things work.

By giving access to these articles, we are spreading resourceful information (a great asset!) across the organization. Hence, knowledge provides: 

  • Informed decisions
  • Improved efficiency because there will be no need to rediscover knowledge
  • A better understanding of the context and interaction with the knowledge consumer

They can be used in many different ways, such as:

  • Helping others understand how something works
  • Providing instructions for how to do something
  • Sharing tips, best practices, and other helpful information

Basically, this is a strategy that makes processes better, faster, and cheaper.

Let's take a look at how you can use and write knowledge base articles to take your support offerings to the next level.

 

 

Knowledge base article definition

A knowledge base article is an information about a product or service the reader can use to learn more about them, access frequently asked questions, or solve everyday problems. Everyone in and connected to your organization can benefit from knowledge articles.

Some benefits include:

  • A central store of valuable articles to eliminate superhero syndrome (a.k.a. single point of failure), meaning you can eliminate the dependence on that one technician who knows all the critical systems inside out. The problem with superheroes is that if the team relies on that one person, they can get burnt out and feel like they can never switch off. Knowledge management takes your team from having one superhero to being a team of superheroes.

  • A central store for end-users to go for all their questions allows everyone to get what they need and get back to work.

  • They can act as a signpost for other services, for example, more information or links to the ITSM tool or service catalog.

  • Better and faster decision-making.

  • 24/7/365 access to organizational knowledge.

Best practices for writing knowledge base articles

Getting your ideas and strategy sorted is always the most difficult part when writing a condensed piece of information. That is why we are presenting you some of the best practices to consider so you don’t leave anything to the imagination of your readers. 

Start where you are

Look at what you have already, for example, incident resolution data from your ITSM tool, software maintenance docs, or hardware installation guides. 

Keep it simple

One of the mistakes when creating content is to make it overly complicated. Stick to an informative overview of the service, its use, common faults and FAQs, pictures and diagrams where appropriate, and links to supporting documentation.

Use links and length wisely

Use anchor links as a table of contents to signpost the reader to the content they need without forcing them to go through unnecessary text or preamble. This is because nothing is more frustrating than a lengthy article with no diagrams, headings, pictures, or links to break it up. Being faced with a wall of text when your end-users are already experiencing tech issues is unnecessary.

Look at your most common faults

Start with your top ten ticket types. What are the things you get asked to fix a day in and day out? No matter your organization type, you will always be asked about network, email, and desktop issues. Make sure you capture that content and have the service restoration documents with screenshots and diagrams to make them easy to follow.

Get inspired by customer questions to drive content 

You’ve looked at the most frequently logged break/fix incidents. Now, let’s look at service requests and customer questions to add value. Use the customer’s own words to capture the question and explain the answer to focus on what the customer needs.

Lean into problem management

Problem management is the practice that can identify the root cause of incidents, repeat IT faults, and create solutions and workarounds. Work with problem management to capture problems, known errors, and so on. Make sure any workaround is documented, shared, and labeled with the appropriate service or CI so everyone can access it.

As Brian Skramstad (IT Service Management Principal at Allianz Technology) said on the 17th episode of our tech podcast, Ticket Volume, it is always a good idea to do user experience research in order to identify problems.

 

 

Make your knowledge articles actionable  

Don’t have static articles that are limited in terms of customer experience (CX).

Add links to related articles and content to drive traffic to the right places. Look for opportunities to be proactive, for example, creating FAQs for new services that will be released soon.

Incentivize your teams

Make your support teams your biggest champions of knowledge management by making the submission of quality articles that are worth their while. Whether it’s a dashboard that highlights the top authors or an Amazon voucher for the best submission of the month – incentivize people to submit knowledge articles so that you get a variety of content.

Shift left and upskill your people

One of our favorite knowledge management principles is “shift left.” Put simply, shift left is where more senior IT technicians in the back office make their knowledge available to the less experienced front-office agents, helping them to answer more difficult customer questions. 

Ask third-line support for tips that second-line support can use and second-line support teams for tips to be handed to first-line support. If you invest time and effort in your people, they’ll become more engaged, it builds loyalty and a sense of team spirit and delivers the required sharing of knowledge.

Create knowledge articles for self-help

Don’t limit knowledge sharing to technical teams. Open it up to end-users too. There’s nothing more frustrating as an end user than ages trying to get through to the service desk for what turns out to be a straightforward resolution. Instead, make a searchable knowledge base available for hints, tips, and FAQs.

Build knowledge sharing into the day job

Make it easy for your people to create and share knowledge articles and build a culture such that it becomes second nature for everyone in IT. The more knowledge management becomes part of the day job, the more articles you generate, and the potential for helping other support teams and ultimately end customers increases exponentially.

Make your content easy to access

There’s no point in having great knowledge articles if no one uses them. Have a central place to share knowledge such that your content is visible to all. Make sure your knowledge articles are easy to find and labeled accordingly.

 

Types of knowledge base articles 

As we mentioned above, a knowledge base article is a type of content that is used to provide information about a specific topic of your organization. It can be used to answer questions, provide instructions, or offer tips and tricks. Based on the intentionality, it’s relevant to know what type of article is appropriate for explaining certain topics.

Informative articles

Informative articles help the reader review a specific system, function, or feature within the product. They aim for end users to help explain something they aren’t familiar with and provide an overview of any available features or options.

How-to articles

These articles are typically written for end-users rather than technical teams and are usually structured as a list to give an overview of a single feature like logging in to the system or changing your password.

"How to" knowledge base articles are typically written for end-users rather than technical teams and are usually structured as a list to give an overview of a single feature like logging in to the system or changing your password.
Image taken from InvGate Service Management’s knowledge base library.

Troubleshooting articles

These address a specific issue a customer is experiencing and offers steps to resolve it. While you can have multiple different options for troubleshooting, they should all be focused on a single problem and labeled accordingly.

Troubleshooting knowledge base articles address a specific issue a customer is experiencing and offers steps to resolve it.
Image taken from InvGate Service Management’s knowledge base library.

Frequently Asked Questions (FAQ) articles

These consist of a list of common questions using the voice and language of the customer. An example of typical FAQs on a shopping platform could include order questions, shipping timelines, and account management. 

FAQ knowledge base articles consist of a list of common questions using the voice and language of the customer.
Image taken from InvGate Service Management’s Knowledge base library.

Knowledge base article templates

Knowledge base article templates are a great way to create content for your organization's knowledge base. These templates are designed to be flexible and customizable, so you can use them for any topic or industry. You can also change the layout and design of the template to match your company's branding.

Keep in mind that, if you need some assistance to fill them with content, you can check out these tips to write good knowledge base articles.

Informational article

Title

  • About (feature/product).

Description

  • Brief outline explanation of the product or feature.

Links to supporting information

  • Bring in context with links to some terms and other topics mentioned in the text.

Product features

  • Feature 1.
  • Feature 2.
  • Feature 3.
  • And so on.

Further information

  • Connect this article to your library with links to related articles or content.

How-to articles

Title

  • Make it a question to a solution: How to. 

Task overview

  • Brief description of the process and the expected results.

Prerequisites if appropriate

  • A list of materials, elements, or software needed to accomplish the task.

Table of contents

  • Show a table of content with links to the steps so they can be reviewed as needed.

Instructions

  • Step 1.
  • Step 2.
  • Step 3.
  • And so on.

Outcome

  • Examples or images that show how the task is expected to turn out.

Further reading

  • Connect this article to your library with links to related tutorial articles or content.

Troubleshooting articles

Title

  • Troubleshooting (incident/problem).

Problem

  • A brief explanation of the issue or issues the reader may be encountering. 

Reasons

  • A short list of why these issues happen.

Links to typical resolution activities

  • If there is more than one solution, add those links.

Potential outcomes

  • A list with examples of the resulted solutions.

Links to further reading

  • Connect this article to your library with links to related troubleshooting articles or content.

FAQ articles

Title

  • Use the voice of the customer to formulate the question.

Subject

  • A brief definition of the topic or feature.

Table of contents

  • List all the questions with anchor links.

Questions

  • Main subject:
    • Question 1.
    • Question 2.
    • Question 3.
  • Sub-subject 1:
    • Question 4.
    • Question 5.
    • Question 6.
  • Sub-subject 2:
    • Question 7.
    • Question 8.
    • Question 9.
  • And so on.

Links to further reading and contact information

  • Connect this article to your library with links to related articles or content.

How to create a knowledge base article in InvGate Service Management

Creating knowledge base articles on InvGate Service Management is a piece of cake. Thanks to our intuitive UX, you can have them published with just a few clicks.

First, go to "Articles" and click on "New Article." Once the editor opens up, you'll be able to choose the article's category, so that it's properly tagged within the knowledge base. After that, write the subject and description (using all the advice we provided above), type your article, and hit publish.

At the top part of the editor, you'll also be able to decide whether you allow user comments, and choose the privacy of the article. 

And that's it! Remember that you can try it yourself with our 30-day free trial.

I have my knowledge base in place. Now what?

The lifecycle of knowledge base articles doesn’t end once they’re published. It’s essential to keep knowledge up to date with metrics so usage and overall performance can be measured. 

InvGate Service Management provides you with insights on the number of views, article effectiveness, amount of comments, amount of times attached to a solution, and the rating average. Plus, there's a dashboard that shows the views and how useful or not it was in a period. 

With all of that data available, you'll be able to build a review cycle into your knowledge articles to ensure that they are correct, relevant, and add value. The “progress iteratively with feedback” concept from DevOps comes in handy here. Write an article, have folks use it, and refine it over time. Add links to related articles and content to drive traffic to the right places. Look for opportunities to be proactive – for example, creating FAQs for new services coming down the pipeline.

Team members across your organization will come up with various ways they want their knowledge base documented. They might use wikis, presentation slides, embedding video instructions within the knowledge base articles, or some other system.

Your work here is to capture these insights and extract constructive feedback. Analyzing this feedback can be very helpful when updating your knowledge base documents or creating resources for external reading lists like the Pixar Wikipedia Academy.

Final thoughts

Knowledge is power; it’s one of the most important assets your organization has, so share it to maximize the benefits. And for that, we believe these following principles condense all the good tips and tricks we’ve talked about:

  • Start small so you don’t get overwhelmed.

  • Be tactical, capture your most frequently logged incidents, and service requests, and document potential fixes and next steps.

  • Just do something! Whatever gets knowledge management started and then improves it over time. If you’re struggling, start with the problem that everyone dreads having to field calls on, and document some quick fixes. Marginal gains like this are something you can build on over time until you’ve got a full-fledged knowledge base.

  • It’s all about value. Writing knowledge articles is all about value creation via the product of actionable knowledge. Whether it’s an end-user trying to learn more about a service, a first-line support analyst fixing a laptop, or a data center engineer addressing performance issues, they’re all going to succeed more quickly with pertinent knowledge to them – better outcomes through actionable, accessible knowledge. 

Frequently Asked Questions

What is a knowledge base in ITSM? 

A knowledge base is a collection of articles, FAQs, and other content that can be used to answer questions. They are often created by IT professionals who have experience with the topic. These articles can be organized into categories or searchable by keyword.

What should be in a knowledge base article? 

A knowledge base article should include the name of the service with a brief overview of what it does, plus troubleshooting steps with diagrams where appropriate.

How do you structure a knowledge base article?

A knowledge base article should include: service, a brief description, a list of benefits for the reader, a list of benefits for the company, and some actionable steps that can be taken to help improve your ITSM program, diagrams, and what to do next if more help is needed.

How can knowledge base articles be used? 

Knowledge base articles are a great way to provide service desk agents with guidance on how to handle specific customer inquiries. Knowledge base articles can be used as a resource for both agents and customers. They are usually written in an article format that is easy to read and follow. These articles can be made available to the public or restricted to just the company's employees.

They can also be used to highlight product features and promote projects pre and post-go-live so everyone, IT and end users, know what to expect.

Is a knowledge article used to support incident resolution?

Yes, it is one of the tools used in the incident resolution process. 

Which is the best way to create and maintain the knowledge base articles? 

Build in a review process with triggered alerts, so no one forgets! Assign an owner to each article or to a group of articles so that there is someone responsible for reviewing and fostering that article.

Read other articles like this : Knowledge Management, IT support, Service desk manager