1. Training Computer Users Writing For End Users

2. What is Training? Focus on performing activities building expertise that will be immediately useful

3. Training Process Plan Prepare Present Progress

4. 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

5. Plan (cont) Determine what trainees already know Define training objectives –Learning objectives: what needs to be learned –Performance objectives: should be able to do

6. 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

7. Prepare (cont) Select Delivery System –Lecture –Reading –Online reading –Group Discussion –Visual Aids –Multimedia –Handouts

8. Prepare (cont) Select Delivery System (cont) –Product Demonstrations –Tutorials (self-guided) –Hands-on Activities –Case Studies –Group/Collaborative –CBT –Web-base Training

9. Prepare (cont) Develop Materials Design Evaluation Methods (Assessment) –Feedback forms –Quiz/Test –Hands-on Activities

10. Present Practice the Presentation Check Facility Early Don’t Read Notes Don’t Cover Too Much Teach Important Skills Monitor Environment Provide Breaks Feedback

11. Progress Evaluate Success of Training Keep Current

12. User Documentation Types Brochures Newsletters Handouts/Training Aids User Guides/Manuals Online Help Systems E-Mail messages Web Pages Proposals, Letters, Memos Troubleshooting Guides

13. Technical Writing Style Short, declarative sentences Short phrases Communicate, not entertain State most important point first Step-by-step sequences Cover essential information

14. Document Organization Sequential Organization Step by step Hierarchical Organization General to specific

15. 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

16. 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?

17. Tech Writing Process Generate idea list Organize into outline Expand to first draft Edit draft Review Revise Proofread

18. Tech Writing Process Paragraphs/topic sentences Transitions Defined Terms Formats (consistency)

19. Writing Strategies Analogy Repetition Consistent Word Use Parallel Structures Consistent Verb Tense

20. Common Problems Clutter Inappropriate Typefaces Gender References Unclear Referents (“they, it”) Passive Voice Nominalization Wordiness

21. Common Problems (cont) Jargon Undefined Acronyms Dangling Phrases

22. Document Evaluation Content Information accurate Coverage complete Organization Easy locate information Transitions identifiable Format Consistent Help guide reader Mechanics