From the course: Technical Writing: Quick Start Guides
Unlock the full course today
Join today to access over 22,600 courses taught by industry experts or purchase this course individually.
Begin each step with a verb
From the course: Technical Writing: Quick Start Guides
Begin each step with a verb
- When you were in sixth grade and suffering through a boring grammar lesson, you might have wanted to ask the teacher, "Why does any of this matter? "Why do I even need to know "the difference between a noun and a verb? "When will I ever use this stuff you're teaching me?" But, now that you're a technical writer working on a quick-start guide, you know you need to understand the parts of speech, especially when you're writing instructions. It's a well known best practice to begin each step in a set of instructions with a verb. After all, verbs are the part of speech we use to show action. It just makes sense because it supports users' efforts to get something done. Here's an example of how confusing it can be when technical writers fail to begin each step with a verb. These are the how to set up direct deposit instructions from the quick-start guide for new Kinetico Incorporated employees. Scan through them for a moment. You can also find a copy of this guide in the exercise files…
Practice while you learn with exercise files
Download the files the instructor uses to teach the course. Follow along and learn by watching, listening and practicing.
Contents
-
-
-
-
-
(Locked)
Address your user directly3m
-
(Locked)
Identify the overall purpose of the guide by explaining the outcome4m 4s
-
(Locked)
Write clear headings4m 1s
-
(Locked)
Begin each step with a verb3m 36s
-
(Locked)
Provide context or notes before steps, not within them3m 1s
-
Use plain language4m 37s
-
(Locked)
Use consistent formatting3m 52s
-
(Locked)
Challenge: Revise a quickstart guide56s
-
(Locked)
Solution: Revise a quickstart guide1m 5s
-
(Locked)
-
-