230 likes | 320 Views
Training Computer Users. Writing For End Users. What is Training?. Focus on performing activities building expertise that will be immediately useful. Training Process. Plan Prepare Present Progress. Plan. Determine Trainees’ Background Determine Content Needs
E N D
Training Computer Users Writing For End Users
What is Training? Focus on performing activitiesbuilding expertisethat will be immediately useful
Training Process Plan Prepare Present Progress
Plan • Determine Trainees’ Background • Determine Content Needs • Determine Skill Levels Needed • Concepts – use basic vocabulary • Understanding – explain concepts • Skills – perform basic task • Expertise – perform tasks effectively
Plan (cont) • Determine what trainees already know • Define training objectives • Learning objectives: what needs to be learned • Performance objectives: should be able to do
Prepare • Specify which topics will be covered • Organize topics • Select effective training environment • Class, group, one-on-one, self-guided • Training method • Problem solve, perform, observe, read, listen • Retention rate
Prepare (cont) • Select Delivery System • Lecture • Reading • Online reading • Group Discussion • Visual Aids • Multimedia • Handouts
Prepare (cont) • Select Delivery System (cont) • Product Demonstrations • Tutorials (self-guided) • Hands-on Activities • Case Studies • Group/Collaborative • CBT • Web-base Training
Prepare (cont) • Develop Materials • Design Evaluation Methods (Assessment) • Feedback forms • Quiz/Test • Hands-on Activities
Present • Practice the Presentation • Check Facility Early • Don’t Read Notes • Don’t Cover Too Much • Teach Important Skills • Monitor Environment • Provide Breaks • Feedback
Progress • Evaluate Success of Training • Keep Current
Brochures Newsletters Handouts/Training Aids User Guides/Manuals Online Help Systems E-Mail messages Web Pages Proposals, Letters, Memos Troubleshooting Guides User Documentation Types
Technical Writing Style Short, declarative sentences Short phrases Communicate, not entertain State most important point first Step-by-step sequences Cover essential information
Document Organization Sequential Organization Step by step Hierarchical Organization General to specific
Document Organization (cont) Introduction Purpose of Document Who the document is intended Why read the document Body General explanation Specific task steps Common problems encountered Summary Additional information pointers
Document Planning Who is the target audience? What does the audience already know? What does the audience need to know? What do you want the audience to be able to do after reading? What medium for document?
Tech Writing Process Generate idea list Organize into outline Expand to first draft Edit draft Review Revise Proofread
Tech Writing Process Paragraphs/topic sentences Transitions Defined Terms Formats (consistency)
Writing Strategies Analogy Repetition Consistent Word Use Parallel StructuresConsistent Verb Tense
Common Problems ClutterInappropriate TypefacesGender ReferencesUnclear Referents (“they, it”)Passive VoiceNominalizationWordiness
Common Problems (cont) JargonUndefined AcronymsDangling Phrases
Document Evaluation • Content • Information accurate • Coverage complete • Organization • Easy locate information • Transitions identifiable • Format • Consistent • Help guide reader • Mechanics