Ce diaporama a bien été signalé.
Nous utilisons votre profil LinkedIn et vos données d’activité pour vous proposer des publicités personnalisées et pertinentes. Vous pouvez changer vos préférences de publicités à tout moment.
INSTRUCTION MANUALS
Best practices for documenting
user instructions and creating
user manuals
INSTRUCTIONS
Documents to help a reader
complete a task
• Actions - personnel (behavior)
• Assembly - objects/mechanism
• ...
TASK & AUDIENCE
ANALYSES
Be clear about purpose
• Regardless of user, task is same
• What exactly will user be able to
do?...
DO A FULL AUDIENCE
ANALYSIS
Complete this form and translate to prose
Know how this analysis affects the instructions, i.e...
DESIGN
Consider:
• Quality of paper
• Frequency of use
• Ease of usability
• Chunking
• Labeling
• Parallel structure
ORGANIZING A MANUAL
What sections are needed?
• Introduction
• Background (identify intended users) “These
instructions ar...
SECTIONS (cont’d)
Instructions
• Actual steps to perform task - be
sure they are logical, sequential
and clear
• Choose a ...
SUPPORT
Frequent Users’ Guide
• List summarizing steps
• Placement (follows full
instructions)
• Consider use - plastic co...
DEVICES FOR LOCATING
INFORMATION
Table of Contents
Pagination - consider dual #s
Previews and Reviews
Cross References
Glo...
CONTENT ELEMENTS
Precise Title - includes purpose:
“Operation Manual for Regal Slow
Cooker” - may use visuals
Necessary co...
Content Elements
(cont’d)
Accurate relevant details only
Appropriate justifications - Is
rationale needed for step?
Necess...
DICTION
Use verb instead of noun for actual
steps, “Turn lever…,” not “Lever
should be turned…”
Be consistent
Include appr...
Diction (cont’d)
Warnings - death or danger
Cautions - hazards
Dangers - immediate
Label & separate visually
Identify the ...
VISUAL AND DESIGN
ELEMENTS
Illustrate parts, sequence of steps,
positioning of operator/equipment,
development of change o...
Best Practices for Writing and Editing User/Instruction Manuals
Best Practices for Writing and Editing User/Instruction Manuals
Best Practices for Writing and Editing User/Instruction Manuals
Best Practices for Writing and Editing User/Instruction Manuals
Best Practices for Writing and Editing User/Instruction Manuals
Prochain SlideShare
Chargement dans…5
×

Best Practices for Writing and Editing User/Instruction Manuals

5 425 vues

Publié le

This presentation outlines industry best practices in writing/editing “user friendly” instruction/user manuals. Instruction/user manuals are written for the purpose of helping the end-user complete a task. These documents must be clear about its purpose. The technical writer must take into consideration the user’s attitude, education, and experience when composing such documents. Methods of organization include a table of contents, pagination, previews and reviews, cross references, glossary, and Index - alphabetical list and page numbers - for longer docs for ease of use. Warnings, cautions, and dangers should also be used throughout the text where appropriate. Appropriate visuals should be used only as needed to aid the user in understanding of the task at hand.

Publié dans : Technologie, Business
  • There is a useful site for you that will help you to write a perfect and valuable essay and so on. Check out, please ⇒ www.WritePaper.info ⇐
       Répondre 
    Voulez-vous vraiment ?  Oui  Non
    Votre message apparaîtra ici
  • Hi there! I just wanted to share a list of sites that helped me a lot during my studies: .................................................................................................................................... www.EssayWrite.best - Write an essay .................................................................................................................................... www.LitReview.xyz - Summary of books .................................................................................................................................... www.Coursework.best - Online coursework .................................................................................................................................... www.Dissertations.me - proquest dissertations .................................................................................................................................... www.ReMovie.club - Movies reviews .................................................................................................................................... www.WebSlides.vip - Best powerpoint presentations .................................................................................................................................... www.WritePaper.info - Write a research paper .................................................................................................................................... www.EddyHelp.com - Homework help online .................................................................................................................................... www.MyResumeHelp.net - Professional resume writing service .................................................................................................................................. www.HelpWriting.net - Help with writing any papers ......................................................................................................................................... Save so as not to lose
       Répondre 
    Voulez-vous vraiment ?  Oui  Non
    Votre message apparaîtra ici
  • Writing a good essay isn't easy and it's the fruit of hard work. You can get help from essay writing. Check out, please HelpWriting.net
       Répondre 
    Voulez-vous vraiment ?  Oui  Non
    Votre message apparaîtra ici
  • Earn Up To $316/day! Easy Writing Jobs from the comfort of home! ★★★ http://t.cn/AieXS5j0
       Répondre 
    Voulez-vous vraiment ?  Oui  Non
    Votre message apparaîtra ici
  • D0WNL0AD FULL ▶ ▶ ▶ ▶ http://1url.pw/ukcC3 ◀ ◀ ◀ ◀
       Répondre 
    Voulez-vous vraiment ?  Oui  Non
    Votre message apparaîtra ici

Best Practices for Writing and Editing User/Instruction Manuals

  1. 1. INSTRUCTION MANUALS Best practices for documenting user instructions and creating user manuals
  2. 2. INSTRUCTIONS Documents to help a reader complete a task • Actions - personnel (behavior) • Assembly - objects/mechanism • Operation - equipment • Implementation of a process
  3. 3. TASK & AUDIENCE ANALYSES Be clear about purpose • Regardless of user, task is same • What exactly will user be able to do? • Caution users by incorporating guidelines/materials needed • What knowledge/experience do users need?
  4. 4. DO A FULL AUDIENCE ANALYSIS Complete this form and translate to prose Know how this analysis affects the instructions, i.e. User attitude - justify steps or entire doc? User education - tech level, defs, visuals? User experience - prior knowledge, details? TRANSLATE TO PROSE
  5. 5. DESIGN Consider: • Quality of paper • Frequency of use • Ease of usability • Chunking • Labeling • Parallel structure
  6. 6. ORGANIZING A MANUAL What sections are needed? • Introduction • Background (identify intended users) “These instructions are for technical writing students who will produce analytical reports…” • Info about how to use manual • Overview, general defs, description, and functions of the equipment process • Theory of operations for those who need to know why, not just what • Project history
  7. 7. SECTIONS (cont’d) Instructions • Actual steps to perform task - be sure they are logical, sequential and clear • Choose a consistent structure • Consider time element
  8. 8. SUPPORT Frequent Users’ Guide • List summarizing steps • Placement (follows full instructions) • Consider use - plastic cover? Trouble-shooting & Maintenance • Anticipate (use testing to discover) • Matrix
  9. 9. DEVICES FOR LOCATING INFORMATION Table of Contents Pagination - consider dual #s Previews and Reviews Cross References Glossary Index - alphabetical list and page numbers - for longer docs
  10. 10. CONTENT ELEMENTS Precise Title - includes purpose: “Operation Manual for Regal Slow Cooker” - may use visuals Necessary components: parts, equipment, materials, steps, accurate chronology Clear, direct working definitions -parenthetical in steps, glossary or appendix, and consistent terminology
  11. 11. Content Elements (cont’d) Accurate relevant details only Appropriate justifications - Is rationale needed for step? Necessary Warnings and Cautions Style and Grammar conventions
  12. 12. DICTION Use verb instead of noun for actual steps, “Turn lever…,” not “Lever should be turned…” Be consistent Include appropriate details Include rationale for steps only if task/audience analysis indicates (consider personal injury)
  13. 13. Diction (cont’d) Warnings - death or danger Cautions - hazards Dangers - immediate Label & separate visually Identify the risk Describe the risk Provide instructions to avoid
  14. 14. VISUAL AND DESIGN ELEMENTS Illustrate parts, sequence of steps, positioning of operator/equipment, development of change of object Appropriate visuals used only as needed (flowchart, diagrams, infographics) Include textual ref, I.d., title Balanced visual and verbal content accurate visuals, easily understood Labeled visuals with relevant text Appealing, usable format

×