Instructions Project

1. Read Instruction pages -- DUE  June 22
--. Read Assignment
2. Instructions proposal -- DUE  June 26
3. Draft Instructions -- DUE  June 29
4. Design Intro/Conc/Safety-- DUE  July 3
5. Complete Instructions-- DUE  July 6
6. Complete Peer Review-- DUE July 10

Instructions Body

Instructions

For today, work on the main steps of the process. Read the section below. Post a draft of your main steps before class on Tuesday. We will meet in the lab to workshop.

The main steps of the process—divided into steps and sub-steps if necessary. Use chronological order, and address the audience directly (active voice, and imperative mood).

Trouble-shooting—if appropriate.

Excerpt from Online Textbook:

Discussion of the steps. When you get to the actual writing of the steps, there are several things to keep in mind: (1) the structure and format of those steps, (2) supplementary information that might be needed, and (3) the point of view and general writing style.

Structure and format. Normally, we imagine a set of instructions as being formatted as vertical numbered lists. And most are in fact. Normally, you format your actual step-by-step instructions this way. There are some variations, however, as well as some other considerations:

  • Fixed-order steps are steps that must be performed in the order presented. For example, if you are changing the oil in a car, draining the oil is a step that must come before putting the new oil. These are numbered lists (usually, vertical numbered lists).
  • Variable-order steps are steps that can be performed in practically any order. Good examples are those troubleshooting guides that tell you to check this, check that where you are trying to fix something. You can do these kinds of steps in practically any order. With this type, the bulleted list is the appropriate format.
  • Alternate steps are those in which two or more ways to accomplish the same thing are presented. Alternate steps are also used when various conditions might exist. Use bulleted lists with this type, with OR inserted between the alternatives, or the lead-in indicating that alternatives are about to be presented.
  • Nested steps. In some cases, individual steps within a procedure can be rather complex in their own right and need to be broken down into substeps. In this case, you indent further and sequence the substeps as a, b, c, and so on.
  • "Stepless" instructions. And finally there exist instructions that really cannot use numbered vertical list and that do little if any straightforward instructional-style directing of the reader. Some situations must be so generalized or so variable that steps cannot be stated.

(See the chapter on lists for the style and format of these possibilities.)

Supplementary discussion. Often, it is not enough simply to tell readers to do this or to do that. They need additional explanatory information such as how the thing should look before and after the step; why they should care about doing this step; what mechanical principle is behind what they are doing; even more micro-level explanation of the step—discussion of the specific actions that make up the step.

The problem with supplementary discussion, however, is that it can hide the actual step. You want the actual step—the specific actions the reader is to take—to stand out. You don't want it all buried in a heap of words. There are at least techniques to avoid this problem: you can split the instruction from the supplement into separate paragraphs; or you can bold the instruction.

Writing style. The way you actually write instructions, sentence by sentence, may seem contradictory to what previous writing classes have taught you. However, notice how "real-world" instructions are written—they use a lot of imperative (command, or direct-address) kinds of writing; they use a lot of "you." That's entirely appropriate. You want to get in your reader's face, get her or his full attention. For that reason, instruction-style sentences sound like these: "Now, press the Pause button on the front panel to stop the display temporarily" and "You should be careful not to ..."

A particular problem involves use of the passive voice in instructions. For some weird reason, some instructions sound like this: "The Pause button should be depressed in order to stop the display temporarily." Not only are we worried about the Pause button's mental health, but we wonder who's supposed to depress the thing (are you talkin' to me?). Or consider this example: "The Timer button is then set to 3:00." Again, as the person following these instructions, you might miss this; you might think it is simply a reference to some existing state, or you might wonder, "Are they talking to me?" Almost as bad is using the third person: "The user should then press the Pause button." Again, it's the old double-take: you look around the room and wonder, "Who me?" (For more detail, see passive-voice problem.)

Another of the typical problems with writing style in instructions is that people seem to want to leave out articles: "Press Pause button on front panel to stop display of information temporarily" or "Earthperson, please provide address of nearest pizza restaurant." Why do we do this? Do we all secretly want to be robots? Anyway, be sure to include all articles (a, an, the) and other such words that we'd normally use in instructions.

Graphics in Instructions

Probably more so than in any other form of writing (except maybe for comic books), graphics are crucial to instructions. Sometimes, words simply cannot explain the step. Illustrations are often critical to readers' ability to visualize what they are supposed to do.

Writing assignments for instructions may ask you to include illustrations or other kinds of graphics—whatever would normally be used in the instructions. The problem of course may be that you don't have access to graphics that would be suitable for your particular instructions, and that you don't feel wildly confident in your artistic abilities. There are ways to overcome these problems! Take a look at the suggestions in graphics. In that chapter, you'll see not only suggestions for creating graphics, but also requirements on their format.

Format in Instructions

Headings. In your instructions, make good use of headings. Normally, you'd want headings for any background section you might have, the equipment and supplies section, a general heading for the actual instructions section, and subheadings for the individual tasks or phases within that section. Take a look at the examples at the end of this chapter. See headings for common requirements.

Lists. Similarly, instructions typically make heavy use of lists, particularly numbered vertical lists for the actual step-by-step explanations. Simple vertical lists or two-column lists are usually good for the equipment and supplies section. In-sentence lists are good whenever you give an overview of things to come. See lists for common requirements.

Special notices. In instructions, you must alert readers to possibilities in which they may damage their equipment, waste supplies, cause the entire procedure to fail, injure themselves or others—even seriously or fatally. Companies have been sued for lack of these special notices, for poorly written special notices, or for special notices that were out of place. See special notices for a complete discussion of the proper use of these special notices as well as their format and placement within instructions.

Number, abbreviations, and symbols. Instructions also use plenty of numbers, abbreviations, and symbols. For guidelines on these areas

Contact Me

Use the following methods to contact me:

Phone: (956) 364 4837 during business hours
Voicemail during after hours.

Email: Use Contact Me link

Chat: Use Chat Rooms to the right or
Yahoo IM: janiesantoy

Chat Now