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 →
Customer self-service portals provide an efficient way for customers to access content, perform convenient transactions and resolve common issues on their own, without having to call or email customer support. But not all self-service portals are created equal. In order to be effective, they need to have certain key features. Read on to find out what top features you should be looking for when building your customer portal.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 →
Customer knowledge is rooted in self-service and is fundamental for any successful business. It strengthens product success, which ultimately, creates a successful customer experience as a whole. And this is so crucial today.continue reading →
Are you looking for ways to create a customer-centric vision and culture in your business? If so, we're here to help. In this post, we'll outline four steps you can take to create a customer-centric culture in your business. Let's get started!continue reading →