Académique Documents
Professionnel Documents
Culture Documents
Preparation
Objectives
This lesson will enable students to:
• Define technical writing.
• Identify characteristics of effective technical writing.
• List differences between technical and creative writing.
• Write step-by-step instructions.
Standards
This lesson aligns with the following National Standards for the English Language Arts:
• Standard 4: Students adjust their use of spoken, written, and visual
language (e.g., conventions, style, vocabulary) to communicate effectively
with a variety of audiences and for different purposes.
• Standard 5: Students employ a wide range of strategies as they write and
use different writing process elements appropriately to communicate with
different audiences for a variety of purposes.
Materials
• “What is Technical Writing” overhead or handout (Appendix A)
• “Characteristics of Effective Technical Writing” overhead or handout (Appendix B)
• 20-30 mouse traps
• 20-30 index-sized cards for instructions
• 20-30 bite-sized chocolate candy bars for bait
• 20-30 Mouse Trap final draft cards with illustration (Appendix C)
• “Mouse Trap Instructions” handout (Appendix D)
• Technical Writing Samples or overheads (www.micron.com/k12/writing/index)
You may use 3x5 cards or print a sheet with 6 illustrated cards for the editing exercise. The
purpose of the smaller work area is to force the students to limit the number of steps and the
number of words. By supplying the illustration for the editing exercise, they don't have to spend
time drawing, only labeling the parts.
Introduction
Introduce yourself and explain briefly your job or the job of technical writers.
Today we are going to discuss technical writing and its importance in the work place.
Q: Keeping this definition in mind, what are some examples of technical writing?
A: Encourage responses from the students and comment on their answers. Answers will vary
but may include: user manuals, instructions and training materials, maintenance manuals,
software documentation, online help for games and software, advertising copy, data books and
catalogs, instructional posters, speeches and presentations, presentation materials, press
releases, newsletters, cookbooks and clothing patterns, scripts for training and promotional
2
videos, business letters, resumes and cover letters, contracts, proposals, grants, feasibility
reports, training materials, questionnaires and forms, research and scientific papers.
Let’s discuss the characteristics of effective technical writing. Show the “Characteristics of
Effective Technical Writing” poster (Appendix B).
Today we are going to practice technical writing—writing instructions. Probably more technical
writers write some sort of instructions than any other type of technical writing. And quite often
the writer does the research, the writing, the editing, and often even the illustrating and
formatting.
Although some companies can afford to hire a team of technical writers with graphic artists to
help them, many companies expect a single writer to do it all. Today you will be working
independently of each other in order to experience the whole process.
You are all working for a company that manufactures mouse traps. As a writer are given the
project of writing instructions for setting a mouse trap. I have a trap and some bait for each of
you to do your own research. I want to assure you that these traps have never been used for
catching mice, only for writing about it.
3
Pass out the mousetraps. If you have new traps, be sure you remove the wrapper or any
instructions that are included. Pass out index sized cards to the students for writing the
instructions.
For bait, I am giving you little chocolate candy bars. Mice love chocolate almost as much as
people do. Pass out the candy.
Because of the time constraints the company is under you have 10 minutes to complete your
first draft. Frequently with technical writing, the writers are the last to know about changes in
the process, equipment, or materials. Because of this, deadlines—often totally unreasonable
deadlines—are a fact of life for technical writers. Please work quickly and quietly.
As students are working, walk around and observe what they are doing so that you will be able
to comment on it later. Refrain from giving any instructions or helping individuals. When the
time is up, you might want to pick up 2 or 3 of the instructions students have written for
illustrations as you discuss the process. The comments in the discussion are just suggestions.
You will have other observations based on what the students are doing.
Discussion
Your time is up. Let's talk about what you have written keeping in mind the characteristics of
good technical writing we talked about earlier. Refer to the “Characteristics of Effective
Technical Writing” handout.
I noticed a few of you did not "research" your project. You simply started writing instructions
based on observation rather than trying it yourself.
In your research, some of you skipped the baiting part, choosing to eat the bait yourself!
And some of you set the whole piece on the bait pedal.
Q: Have you ever set a trap and had the bait disappear with the trap unsnapped?
A: You only need a bit of the candy, but if the bait isn't pressed into the pedal firmly, the
mouse will be able to get it without getting caught.
4
I also noticed a few of you got your fingers snapped.
Q: Why do you need an illustration if they have the mousetrap in their hands?
A: Answers should include the comment "to label the parts so you don't have to describe them
in the written instructions." The illustration right next to the instructions allows you to be more
concise and increases accessibility.
Q: Did you include some instructions about where to set the trap?
Q: How many steps do you have? How many words in those steps?
A: Wait for their responses, then hold up one of the mouse trap wrappers.
Think about conciseness. This is how much space the actual instructions have—1 1/2 inch by 4
inches—and they are given in three languages! They have only 3 numbered steps, for a total of
only 29 words plus 3 labels on the illustration. It also has instructions for removing the staple
which held down the locking bar, which you didn't know about since it had already been
removed the first time they were used. These instructions, however, could be improved, as we
will talk about later.
We are also going to come to a consensus about what to call each part. Sometimes this is the
hardest part—thinking of appropriate, descriptive names.
For example, to call this part (point to the bow) the "killer thing" might be descriptive, but it is
not appropriate and could be considered offensive. And we probably don't need to label this
part (point to the spring) because we don't need to refer to it in our instructions.
5
Editing
Now we are going to the next step in the process: Editing. A majority of technical writing
involves revising, editing, and improving existing documents, not creating new documents.
You have done your research, written a first draft, and created an illustration. I am going to ask
you to edit and rewrite your instructions. This time I want you to limit your number of steps to
no more than 4 and limit your number words to no more than 12 words per step. Less would be
better. Your warning can be in addition to the steps.
Editing Discussion
Q: Were you able to stay within the guidelines: Four steps and
no more than 48 words, not counting the warning.
A: Wait for and encourage responses.
Let’s look at the instructions that came with the traps. I have
enlarged them so you can see and removed the foreign
languages. Pass out the instructions.
6
include the following. Point out the problems they don't notice.
• No warning or caution.
• “Step” 1 really is two steps.
• It doesn't say anything about pressing the bait in firmly.
• The word 'engage' in step 2 may not be the best choice for a general audience. What
would be better?
• The last step doesn't really tell us where to place the trap—where signs of mice have
been seen.
• What about the capital letters in the sentences? Are they all necessary?
There is always room for improvement. Even the professionals who wrote these instructions
might want to rewrite them.
It isn't just professional technical writers who write. No matter what your job in the future, you
will probably find yourself having to explain a process, describe a procedure, or instruct
someone about something—in writing.
Conclusion
If time allows describe a typical day for a technical writer, share samples of your work, answer
any questions the students may have about technical writing. You might also discuss the
difference between technical and creative writing using the information below.
Close presentation and gather up mousetraps. If you have enough candy, you might share it
with students.
Q: What differences can you think of between creative and technical writing?
A: Answers may include the following responses.
• Creative writing is fictional and imaginative while technical writing is factual.
• Creative writing is entertaining, provocative, and captivating while technical writing is
informative, instructional, or persuasive.
• Creative writing can be artistic, figurative, symbolic, ambiguous, even vague, but
technical writing needs to be clear, precise, and straightforward, leaving no room for
7
misinterpretations. It needs to follow accepted standards for grammar and format, while
creative writing can break the rules.
• Creative writing is subjective, with the thoughts, opinions, and attitudes of the writer.
Technical writing must be objective.
• Creative writing uses a general vocabulary understood by a general audience narrowed
somewhat by age group or interest. Technical writing uses specialized vocabulary
dependent on the topic as well as on the familiarity of the target audience with the
topic.
• Creative writing can be lucrative for the few who create best sellers but technical writing
provides career opportunities with good salaries for thousands and thousands of writers
in all kinds of businesses and industries.
8
Appendix A – Technical Writing
9
Appendix B – Technical Writing
10
Appendix C – Technical Writing
11
Appendix D – Technical Writing
12