Updated:
Published:
May 1, 2023
•
•
12 min
If you were today years old when you learned what the acronym “QSG” stands for, you’re in good company. We live and breathe all things documentation, and that was a new one for us, too.
We may need to brush up on what the cool kids are calling them, but we love a quick start guide. If you’re in the business of teaching people how to use software and you aren’t already familiar with QSGs, prepare to have hearts for eyes.
Since understanding how QSGs differ from other types of documentation can be confusing, let’s take a look at one of their closest cousins.
Just in case the distinctions aren’t jumping out at you, here’s a more detailed explanation. 👇
You may hear people talk about user manuals, too—but those are d-e-t-a-i-l-e-d documents. They usually cover more advanced features that quick start guides and quick reference guides won’t.
Now that that’s cleared up, we’ll give you the full rundown on quick start guides—including their biggest benefits, best-in-class examples, 9 tips to keep your end user front and center, and a checklist to help you whip up one of your own.
A quick start guide is a great example of documentation that punches well above its weight.
It’s also a choose-your-own-adventure situation, with lots of different types to choose from. 👇
Research shows:
Quick start guides go hand-in-hand with onboarding, and we could talk about the benefits of both all day. That said—since we’re talking about the beauty of brevity today—we’ll keep it short and sweet.
Here are nine advantages to including a quick start guide in your onboarding process:
If it’s all in one ear and out the other until you see a practical example, this section is for you. 😎 First, a quick overview on formatting options.
While every company (and creator) approaches quick start guides differently, there are a couple of formats you’ll see all over the place. One may strike you as a no-brainer over all others, depending on your needs and available resources. Or you may decide to mix and match a few to create the best experience.
You can approach your QSG through:
To get your wheels spinning, here are five quick start guide examples.
For people with answers to FAQs:
Tango makes documentation easy, fast, and fun by automatically generating how-to guides with screenshots.
When the inevitable “How do I…” question comes your way, Tango makes it simple to share your expertise, avoid hours of tedious documentation, and help everyone around you get stuff done—with fewer impromptu requests to screen share. 🙏
For people looking for answers to get unstuck:
Teaching people how to use a how-to tool *with* a how-to may be slightly meta, but it’s undeniably effective.
After watching a quick demo and clicking the quick start guide link, new users learn how Tango works in-app, in the flow of their work, while viewing their first Tango. On-screen guidance makes it easy to know exactly what to do next—while saving mental energy and minimizing mistakes. 🕺
It’s hard to imagine a world without Slack. When you need to help a new employee streamline communication and collaboration, there’s this treasure trove of information.
Slack’s online quick start guide delivers on its promise. With instructions to download the desktop app, view a short video, and zip through a quick tour, it couldn’t be easier to set up your digital HQ.
Asana is a web-based project management software that allows teams to collaborate and manage their tasks and projects more efficiently. (If you haven’t tried it yet, it is nothing short of ✨.)
They also take an online approach to their quick start guide, with a structure that accelerates the process of finding what you’re looking for. Their guide uses text, video, and animations, and includes a high-level overview of how their program is organized alongside key things you can do.
Salesforce is a cloud-based customer relationship management (CRM) software that helps businesses manage their sales, marketing, customer service, and other business functions in one place.
Since there’s a lot to learn, Salesforce has many, segment-specific quick start guides. This one's for small businesses who want to use Salesforce, and covers the basics, how to track customers and close deals, how to manage contacts, tips to resolve customer issues, and a glossary. There’s also a chatbot for real-time support, and a call to action to try the product out for free.
Wistia is a video marketing platform that makes it easy to find, engage, and grow your audience with video.
You may not be surprised to learn that their demo video doubles as a quick start guide, with tips for hosting, marketing, analyzing, and creating video.
If the only thing you like better than a practical example is an actionable tip, we can do you one better—with a round-up of 9 best practices for creating user-centric quick start guides.
We like personas as much as the next person. But to create a 🤩 quick start guide, there’s no substitute for talking to customers. It’s a good idea to connect with both inactive users (to suss out areas for improvement) and successfully onboarded users (to see what’s working).
Issuing a survey works well for gathering quantitative data. You can ask questions like:
You can also dig into:
To collect qualitative insights, you can take a 1:1 or 1:many approach. User research sessions can be particularly helpful—especially if you have people sign up to use your product and/or run through your quick start guide while they’re on a video call with you. Seeing where people get stuck IRL can be hugely illuminating—and open your eyes to missed expectations and opportunities.
Is there a discrepancy between how you’re messaging your product (perceived value) and the value your users actually receive in the product (experienced value)? If yes, that’s a good signal your quick start guide isn’t quite hitting the mark.
This one hits home, doesn’t it? 🎯 Creating a PDF probably wouldn’t require support from a videographer or an animator. Hosting a webinar probably wouldn’t require a web developer or too much time from your best graphic designer. But to truly take a customer-first approach to your onboarding documentation, you need to think about what would serve your user best.
Ultimately, you want your customers to find success—so understanding what success means to them and figuring out how your documentation helped (or hindered 😟) is key.
The average human attention span is 8.25 seconds. We officially have a shorter attention span than goldfish. This means it’s critical to keep your “quick” reference guide from being too comprehensive—and difficult to digest.
If onboarding is a path towards value, you want that path to be as direct as possible, with no obstacles in the way. Your goal is to help your users reach the “aha!” moment—where they realize how useful your product is—ASAP. Every piece of content in your quick start guide should accelerate the movement towards that moment. If it doesn’t, cut it out ✂️.
The temptation to squeeze in ALL the cool things about your product is real. But to keep your quick start guide from morphing into a user manual—and to keep your end user top of mind—separate what’s necessary to know from what can be taught later on. It’s a good thing if the latter is a long list! That just means you have plenty of ways to add consistent value over time (which will help with retention).
What percentage of non-technical people make up your audience? If it’s anything other than 0%, write as if your reader has no prior knowledge of or experience with your product.
Your engineering team likely puts lots of effort into shipping new solutions. And your product team likely puts lots of effort into naming them. It makes sense to want both teams to have their moment in the sun! But if you aren’t careful, your quick start guide may start to sound like an announcement of something awesome that you built—vs. an application that helps users understand how they can solve their problems. Focus on contextual application, or how your product can help to drive an outcome, rather than rattling off feature names.
As anyone who creates documentation knows—maintenance is ongoing. And also: not the most fun. That said…your quick start guide will only be as useful as it is accurate. This is especially true when writing technical documentation since product updates can easily make your QSG obsolete. Work with your product, engineering, marketing, sales, and customer success teams to create a plan to update your guide whenever there are big updates to your product roadmap.
When you pick a format for your quick start guide, think about the things that will help users feel the most supported through setup and beyond. Is that a chatbot on a website? A link out to a knowledge base from an infographic? Or a step-by-step tutorial with a literal “Guide Me” button?
To deliver on our initial promise to you—here’s a Notion checklist to help you create a quick start guide in no time.
TL;DR: It’s hard to overstate the importance of the first interactions people have with your product, service, or software.
Potential users shouldn’t have to guess or work hard to understand your product. They should be able to understand what it is and why they should use it in a glance. That’s where quick start guides come into play—and show that (sometimes) less really is more.
Quick start guides and instruction manuals are both types of documentation that provide information on how to use a product. Here’s how to differentiate the two: A quick start guide is a simplified and condensed version of an instruction manual, with the goal of sharing the essential information needed to get started with a product quickly. An instruction manual, on the other hand, is a more comprehensive and detailed document, with the goal of helping users who want to explore a product's full range of features and capabilities.
Quick start guides are beneficial for a variety of reasons, including:
Exactly as long as it needs to be to help users get started using your product, and not a single word, flowchart, video, GIF, or progress bar longer. 🙂
We'll never show up
empty-handed (how rude!).