4 min read
“How-to guides” are just as they sound, they are kb articles that guide your customers through exactly how to do something, step by step. This could be setting up a new device, creating accounts, troubleshooting common problems, or any other [technical documentation or product support your customers commonly need.]
These can be fairly simple to write, however, after [planning your technical documentation], you might discover that you have dozens, even hundreds, that you need to author. So, working from a template, rather than from scratch, each time you write an article can streamline the process. Plus, if you have a team of writers creating articles, using a singular template can ensure consistency.
Now, there are plenty of “how-to guide” templates out there, but how do you know which one is best? You don’t want to write hundreds of articles based on a single template only to discover that you left out something super important in each one. Luckily, we have done the work for you and combed through all of the templates you might decide between to make the ultimate “how-to guide template,” complete with everything your customers may need.
Simply, start with our template below, plug in your own copy and images, and voila!
Begin with a brief introduction to your content. Talk about what topics you will cover, why a customer may need this information, and any preliminary knowledge they may need to understand the article. For example, if this guide is about connecting a device to your phone, you might want to mention here that they should first get their WiFi configured (and link to the guide on how to do so).
In this guide, we will cover the following topics: (Be sure to link these bullet points to their accompanying subtitles below)
You won’t always need to include this section, but if you are discussing a topic that your customers know nothing about, it can be helpful to explain what exactly you are instructing them to do. For example, connecting a device to your phone is something most of us can wrap our brains around. But, if you are writing a guide on how to turn on the device’s auto-pairing feature, you might want to first explain what auto-pairing is, how it works, and why customers should be interested in that feature.
Think of this section as a way to convince your customers that following the next set of instructions will be worth it. You can also use this opportunity to link to other related how-to guides that customers may also find useful.
Now, it’s time to guide the customer through how to do a specific process, step by step.
Now that you’ve explained the basic step-by-step process that all customers can understand, feel free to add an additional section with more advanced information. This might be advanced settings, more detailed info on what you’ve already discussed, processes that are only available to certain customers, or anything else.
Keep in mind, you can have as many “step-by-step instructions” or “advanced instructions” as you need in each guide. It doesn’t need to be just one of each! Though try not to overwhelm customers by including a million different things in one guide. If you must, be sure to include the table of contents for easy navigation!
Don't forget to add images to this section as well! Use visuals as often as you can with any how-to guide.
Your conclusion should be brief and simple. The most important part is to link out to other how-to guides that naturally relate to this one.
Try saying something like, “Continue learning about X by reading Y.”
After starting with our template, learn the basics of writing a kb article, and read about a few examples of great ones that can inspire yours. If you’re building your knowledge base from scratch, check out our blog on how to plan all of the technical documentation you will need.
That's not all! Our blog has tons to offer. Explore more posts below to keep learning!
As the world increasingly moves online, businesses are looking for ways to improve their customer experience (CX). Building digital customer experiences does not have to be complicated or time-consuming. With the right tools and approach, you can create amazing customer experiences without a single line of code. In this blog post, we'll discuss different approaches to creating managing, and optimizing the customer experience.continue reading →
There is a lot to consider when evaluating and selecting the best system for your needs. In this blog, we will cover where to search for solutions and what to include on your shopping checklist.continue reading →
There has been a monumental shift in the way customer service happens. The top companies in the world have set a new standard for what service and support can be, encouraging all others to follow in their footsteps. And this standard is self-service.continue reading →
With so many benefits, it's no wonder that knowledge base software is becoming increasingly popular among businesses of all sizes. If you're considering investing in knowledge base software for your company, this article will give you an overview of the benefits and key features to look for.continue reading →
Are you looking to improve the efficiency and effectiveness of your customer support processes? One solution to consider is Knowledge-Centered Support (KCS). This blog will provide a step-by-step guide on successfully implementing KCS in your organization. From assessing your current knowledge management practices to training and educating employees, we'll cover all the key steps to ensure a smooth and successful adoption of the methodology. Following these best practices can streamline support processes, reduce the need for repetitive tasks, and improve the overall customer experience. Let's get started!continue reading →