Individually, you will write a 1500-2000-word instructional or training manual that demonstrates: 1. ability to explain a task/process in clear, concise language. 2. selection and definition of appropriate terminology and concepts. 3. awareness of the intended user/audience. 4. knowledge of instructional manual format. All diagrams, illustrations, or photos must be created by the student and integrated into his or her manual. Any outside sources cited should be documented according to APA format.

Instructional or Training Manual

• For our purposes, we will say instructional manuals are external facing, meaning they are meant for end users, customers, or clients.
• Training manuals are internal facing documents, meaning they are meant for employees, contractors, and colleagues.
• You choose your audience (internal or external).
• Its word count should be 1500-2000 words.
• Combine words with pictures, illustrations (drawings), and/or screenshots. Any images that you use must be created by you or taken by you.
• Clearly define the purpose of your manual. What does it teach? What does it help a person do? What task or tasks does it help someone complete in a straightforward and easy manner?
• Telling versus showing. Always aim for showing, but provide the telling as context, clarification, and additional information.
• Use the body of your document for writing, steps, etc. Don’t be afraid to include text boxes and end notes.
• Provide a cover sheet, table of contents, introduction/purpose, and glossary of important terms. It can be as few or as many pages as needed.
• Be consistent with your explanations and learn from similar kinds of manuals about what terms you should be using to explain how to do something (e.g., tapping, pressing, clicking, holding, dragging, typing, etc.).

Let’s look at some examples (use Google, the terms below, and “filetype:pdf” modifier).

• PDAC Guidelines and Steps (telling)
• IKEA Billy Bookcase (showing)
• Training Express’ Windows 98 Level I Training (telling and showing)
• QUE’s Learn Windows 7 (telling and showing)
• ASRock Z97 Anniversary Motherboard Manual (telling and showing)
• Amazon Web Services’ Amazon Elastic Compute Cloud, Windows Instances (telling and showing)

Find your own examples for ideas and inspiration. The reading for this section of the class has to do with your own research into what instruction manuals look like.

Think about what you know enough about that you can teach it to someone else and it is something that you want to include in your professional portfolio.

Of course, choose a task or process that you have realistic access to the hardware, software, etc. that you will need for creating your instruction manual.

• During class (or if you were absent, ASAP): email me a memo with three manuals, links, and description of good/bad qualities of each.
• Before our next class: create a new document and write the list of procedures that you plan to elaborate on in your manual.
• New due date for the project–one additional week to work on it: November 3.