Technical Writing: Quick Start Guides
58mBeginner2018-06-08
Authors
Leslie O'Flahavan
Online Writing Expert
Course details
A quickstart guide is a short, getting-started document that usually accompanies a product or software. In this course, writing instructor Leslie O'Flahavan explains the components, best writing practices, and overall strategy for creating a quickstart guide that helps readers easily find answers to their questions. Leslie shares how to base your quickstart guide on your user manual or develop your guide by using customer feedback. She also discusses how to clearly identify the overall purpose of your guide, write clear headings, and use plain language. To wrap up, she covers methods for getting feedback from subject matter experts and users to ensure that your guide is both accurate and useful.
Learning objectives
Explain the difference between a conceptual guide and a procedural guide.
Determine how to address a user when writing a quickstart guide.
Recall a tactic that helps avoid too many notes.
Identify the benefits of using plain language.
Name the most important aspect of formatting.
Learning objectives
Explain the difference between a conceptual guide and a procedural guide.
Determine how to address a user when writing a quickstart guide.
Recall a tactic that helps avoid too many notes.
Identify the benefits of using plain language.
Name the most important aspect of formatting.
Skills covered
WritingLimited SeriesProfessional Development
Concepts
0. Introduction
- 01 - Welcome
1. Components of a Quickstart Guide
- 02 - Know what you want the guide to accomplish
- 03 - List steps - Sequence or separate tasks
- 04 - Incorporate visuals into your quickstart guide
2. How to Develop Your Quickstart Guide
- 05 - Base your quickstart guide on your user manual
- 06 - Base your quickstart guide on input from users
3. Best Writing Practices for a Quickstart Guide
- 07 - Address your user directly
- 08 - Identify the overall purpose of the guide by explaining the outcome
- 09 - Write clear headings
- 10 - Begin each step with a verb
- 11 - Provide context or notes before steps, not within them
- 12 - Use plain language
- 13 - Use consistent formatting
- 14 - Challenge - Revise a quickstart guide
- 15 - Solution - Revise a quickstart guide
4. Check Your Quickstart Guide for Accuracy and Usefulness
- 16 - Ask a subject matter expert to review your quickstart guide
- 17 - Ask users to review your quickstart guide
Conclusion
- 18 - Next steps