Writing a User Manual
Read https://web.archive.org/web/20150715004105/http://online-learning.com/five-tips-writing-user-manual/.
1 Differences From Labs 1 Through 3
Lab 4 is a User Manual. The pseudo-informal nature of such a document lets you:
Ignore APA!!!Relax selected APA rules (based on class discussions)- Use first, second, and third person!!!
- Use hype, cute phrases, and be entertaining!!!
- Use multiple exclamation points!!!!!!!!
Treat the prose as if you are looking directly at someone who has just purchased your product. They have just invested in you. You are grateful (and helpful) as a result. The first section should tell them that.
“Thank you for buying our product! Your problems will no longer exist! We have designed this exciting new software so that it is easy to use…”
User manuals are filled with:
- Illustrations
- Step-by-step instructions – “Step 1”
- Directions for handling errors
- Trouble shooting guidelines
- No long paragraphs!
2 The Formal Stuff
Yes… formal stuff. While you have latitude to write in a more conversational style, we can not relax all the rules. You must still include:
- A Title Page
- A Table of Contents
- A Listing of Figures
- A Listing of Tables
- A Glossary of Terms
3 Consistent Formatting & Diction
Formatting must be consistent. This includes the standard fare:
- Font (i.e., typeface)
- Font size
- Emphasis (e.g., bold vs italics)
- Color use
and considerations in your figures. If you are annotating figures, you must do so consistently. Consider a case where you need to enumerate elements in a figure (usually a screenshot).
- Do you use letters? Lowercase? Uppercase?
- How about Roman Numerals? Lowercase? Uppercase?
- How about numbers?
It does not matter which method you choose. Just be consistent. This includes font and color.
4 Include UI Screenshots
Every User Interface (UI) screen should (there may be a few exceptions…) be included in the user manual.