What are definitions,           descriptions, and instructions?• A definition is typically a brief explanation of  an item...
Definitions have two main uses:• Definitions clarify a description of a new  development or a new technology in a  technic...
Use these four strategies when definingterms for readers from another culture:• Add a glossary (a list of definitions).• U...
There are three types of definitions:• parenthetical• sentence• extended Chapter 20. Writing Definitions, Descriptions, an...
Sentence definitions follow a typical pattern: Item = category + distinguishing characteristics   Chapter 20. Writing Defi...
Follow these four guidelines to    write effective sentence definitions:•Be specific in stating the category and thedistin...
Eight techniques are             used in extended definitions:• graphics• examples• partition• principle of operation• com...
Decide where to place the definition:• in the text• in a marginal gloss• in a hyperlink• in a footnote• in a glossary• in ...
Descriptions are verbal and visual         representations of three items:• objects• mechanisms• processes   Chapter 20. W...
Follow these four principles                when writing descriptions:• Clearly indicate the nature and scope of the  desc...
Answer these five questions to introduce  object or mechanism descriptions:• What is the item?• What is the function of th...
Answer these six questions to         introduce process descriptions:• What is the process?• What is the function of the p...
Provide appropriate detail in mechanism and object descriptions:• Choose an appropriate organizational  principle:     fu...
Provide appropriate detail                   in process descriptions:• Structure the step-by-step description  chronologic...
An example of a process         description based on a graphicChapter 20. Writing Definitions, Descriptions, and Instructi...
Consider five questions    when designing a set of instructions:• What are your reader’s expectations?• Do you need to cre...
Follow these two guidelines        to design clear, attractive pages:• Create an open, airy design.• Clearly relate the gr...
Examples of cluttered                        and attractive page designsSource: Slide-                                    ...
Understand the four signal words      used in manuals and instructions:• Danger indicates an immediate and serious hazard ...
An example of a safety labelChapter 20. Writing Definitions, Descriptions, and Instructions   © 2012 by Bedford/St. Martin...
A typical set of instructions            includes these four elements:• title• general introduction• step-by-step instruct...
Write effective titles for instructions:Effective titles:• How-to. “How to Install the J112 Shock  Absorber”• Gerund. “Ins...
Consider answering these six questionswhen drafting introductions for instructions: • Who should carry out this task? • Wh...
Follow these six guidelines     when drafting steps in instructions:• Number the instructions.• Present the right amount o...
Typical elements in the                     front matter of a manual:•    introduction or preface•    overview of the cont...
Typical elements in the                   back matter of a manual:• set of specifications• list of safety regulations and ...
Consider these three questions whenwriting instructions for multicultural readers:  • In what language should the informat...
Upcoming SlideShare
Loading in …5
×

Ch20 slides

2,316 views
2,162 views

Published on

Prof. Wozencraft
ENG227

Published in: Education, Business
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
2,316
On SlideShare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
6
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Ch20 slides

  1. 1. What are definitions, descriptions, and instructions?• A definition is typically a brief explanation of an item or concept using words and (sometimes) graphics.• A description is typically a longer explanation, usually accompanied by graphics, of an object, mechanism, or process.• A set of instructions is a kind of process description intended to enable a person to carry out a task. Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 1
  2. 2. Definitions have two main uses:• Definitions clarify a description of a new development or a new technology in a technical field.• Definitions help specialists communicate with less knowledgeable readers. Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 2
  3. 3. Use these four strategies when definingterms for readers from another culture:• Add a glossary (a list of definitions).• Use Simplified English and easily recognizable terms in definitions.• Pay close attention to key terms.• Use graphics to help readers understand a term or concept. Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 3
  4. 4. There are three types of definitions:• parenthetical• sentence• extended Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 4
  5. 5. Sentence definitions follow a typical pattern: Item = category + distinguishing characteristics Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 5
  6. 6. Follow these four guidelines to write effective sentence definitions:•Be specific in stating the category and thedistinguishing characteristics.•Don’t describe a specific item if you are defining ageneral class of items.•Avoid writing circular definitions.•Be sure the category contains a noun or a noun phraserather than a phrase beginning with when, what, orwhere. Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 6
  7. 7. Eight techniques are used in extended definitions:• graphics• examples• partition• principle of operation• comparison and contrast• analogy• negation• etymology Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 7
  8. 8. Decide where to place the definition:• in the text• in a marginal gloss• in a hyperlink• in a footnote• in a glossary• in an appendix Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 8
  9. 9. Descriptions are verbal and visual representations of three items:• objects• mechanisms• processes Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 9
  10. 10. Follow these four principles when writing descriptions:• Clearly indicate the nature and scope of the description.• Introduce the description clearly.• Provide appropriate detail.• Conclude the description. Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 10
  11. 11. Answer these five questions to introduce object or mechanism descriptions:• What is the item?• What is the function of the item?• What does the item look like?• How does the item work?• What are the principal parts of the item? Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 11
  12. 12. Answer these six questions to introduce process descriptions:• What is the process?• What is the function of the process?• Where and when does the process take place?• Who or what performs the process?• How does the process work?• What are the principal steps of the process? Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 12
  13. 13. Provide appropriate detail in mechanism and object descriptions:• Choose an appropriate organizational principle:  functional  spatial• Use graphics.Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 13
  14. 14. Provide appropriate detail in process descriptions:• Structure the step-by-step description chronologically.• Explain causal relationships among steps.• Use the present tense.• Use graphics. Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 14
  15. 15. An example of a process description based on a graphicChapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 15
  16. 16. Consider five questions when designing a set of instructions:• What are your reader’s expectations?• Do you need to create more than one set of instructions for different audiences?• What languages should you use?• Will readers be anxious about the information?• Will the environment in which the instructions are read affect the document design? Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 16
  17. 17. Follow these two guidelines to design clear, attractive pages:• Create an open, airy design.• Clearly relate the graphics to the text. Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 17
  18. 18. Examples of cluttered and attractive page designsSource: Slide- Source: Anthro,Lok, 2005 2005<www.slide- <www.anthro.com/lok.com/ assemblyinstructioassembly/P246 ns/300-5237-00.pdf8/P2468.pdf>. >. Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 18
  19. 19. Understand the four signal words used in manuals and instructions:• Danger indicates an immediate and serious hazard that will likely be fatal.• Warning indicates the potential for serious injury or death or serious damage to equipment.• Caution indicates the potential for anything from moderate injury to serious equipment damage or destruction.• Note indicates a tip or suggestion to help readers carry out the procedure successfully Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 19
  20. 20. An example of a safety labelChapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 20
  21. 21. A typical set of instructions includes these four elements:• title• general introduction• step-by-step instructions• conclusion Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 21
  22. 22. Write effective titles for instructions:Effective titles:• How-to. “How to Install the J112 Shock Absorber”• Gerund. “Installing the J112 Shock Absorber”Ineffective titles:Noun strings. “J112 Shock Absorber Installation Instructions” Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 22
  23. 23. Consider answering these six questionswhen drafting introductions for instructions: • Who should carry out this task? • Why should the reader carry out this task? • When should the reader carry out this task? • What safety measures or other concerns should the reader understand? • What items will the reader need? • How long will the task take? Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 23
  24. 24. Follow these six guidelines when drafting steps in instructions:• Number the instructions.• Present the right amount of information in each step.• Use the imperative mood.• Don’t confuse steps and feedback statements.• Include graphics.• Do not omit articles (a, an, the) to save space. Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 24
  25. 25. Typical elements in the front matter of a manual:• introduction or preface• overview of the contents• conventions section• “where to get help” section• list of trademarksChapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 25
  26. 26. Typical elements in the back matter of a manual:• set of specifications• list of safety regulations and industry standards• tips on maintenance and servicing• copyright page• index• glossaryChapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 26
  27. 27. Consider these three questions whenwriting instructions for multicultural readers: • In what language should the information be written? • Do the text or graphics need to be modified? • What is the reader’s technological infrastructure? Chapter 20. Writing Definitions, Descriptions, and Instructions © 2012 by Bedford/St. Martins 27

×