Lesson 1: What is Technical Writing?
A. Technical writing defined
B. Who does technical writing?
a. Engineers, project managers, developers
b. Technical support staff
c. Specialists in technical writing
C. What fields use technical writers?
b. Consumer and industrial electronics
c. Medical procedures and equipment
d. Any field where technical information needs to be made accessible to lay learners
D. About this course
a. Introduction to the kinds of projects technical writers work on
b. Things to consider when approaching a technical writing project
c. A look at the kinds of materials technical writers produce (and they're not all written!)
d. Information on building a career as a technical writer
Lesson 2: Projects for Technical Writers
A. software documentation
a. online help files
b. user's manuals
c. quick start guides
B. Product and equipment manuals
a. Hard-copy user's manuals
b. Online support
c. Instructional materials
C. Other formats for technical communication
b. Audio and video documentation and instruction
c. Creative formats
i. Google's browser manual written as a comic book
Lesson 3: The Technical Writing Process
A. consider the audience
a. what general level of skill and experience does the end user have?
b. Which terms can be used freely, which terms need to be define, and which terms should be avoided?
c. What style of writing will best communicate with the end user
d. Which information is most critical for the user's successful use of the product?
B. Define the deliverables
a. Choices, choices. The array of formats available for technical writers is growing.
i. Hard copy manuals
ii. Electronic documents (pdf)
iii. Online help platforms
b. Which deliverable gives the producer maximum benefit for the least cost?
C. Learn the technology
a. Consulting S.M.E.'s
b. Learning from other users
c. Learning for oneself
d. "meta-learning:" the successful technical writer doesn't just learn the application, he or she watches the learning process, noting where it is challenging and what pitfalls tend to slow it down. Meta-learning is invaluable when the time comes to help others learn
D. Organize the knowledge
a. Toward a project outline
b. Multi-sourcing vs. single sourcing
c. Getting feedback from colleagues, SME's, and users.
D. Write and revise the draft. For details on the nitty gritty of good technical writing style, see Lesson 5
Lesson 4: How to Write effectively: At it's core, good technical writing is simply good writing about technical subjects. Here are some general guidelines on producing clear, understandable, readable writing that will help your readers gain the information they need.
A. Clarity and simplicity.
i. Write like you talk
ii. Simplify when you can
iii. Use examples
B. Correct grammar and punctuation:
i. Using reference materials
ii. Using Style manuals
C. Use visual aids
D. Style and the technical writer
Lesson 5: Teaching an Alien to Drive: If you've ever taught a teenager to drive, you know you don't really have to start from scratch. The average kid will know where to put the key and how to start the engine just from watching his parents do it. But what if an alien landed on earth and asked you to teach it to drive? Successful technical writing is all about giving your audience the information it needs without going too far over or under its head. Let's watch technical writing in action as we teach an alien to drive.
A. Breaking down the steps
B. Defining terms, explaining concepts
C. Selling the benefits
D. Creating the deliverable
Lesson 6: The First End User: You
A. How to learn new applications quickly
a. Do you have the love?
b. Ask dumb questions
B. Get to know your own learning process
b. Watch someone else
C. Document your progress
a. What's hardest about learning this application
b. What's easiest
D. The butterfuly net and the jar: catching bugs and resolving issues
a. Technical Writers as beta testers.
b. Don't be a witch hunter
E. Zen mind, beginner mind
a. Keep the beginner in mind, no matter how skilled you get
b. Be mindful as you learn
Lesson 7: Getting it Done. Project Management and the Technical Writer
A. Defining a timetable
a. When does the product launch?
b. Is the product finished?
c. Who makes the decisions?
B. Assigning Tasks
a. Do you have a staff, or are you on your own?
b. Outsourcing and the technical writer
a. Dealing with SME's
b. Keeping everyone on track
c. Check your ego at the door
D. Feedback from users
a. Is the documentation working?
b. Are you using the best deliverable medium?
E. Keeping momentum
a. Keep an eye on the calendar
b. See how far you've come
F. Staying on top of it.
a. Dealing with writer's block
b. Dealing with slowpokes
Lesson 8: Words, Pictures, and Links: The Growing Array of Deliverable Formats
A. Put it in Writing
a. Hard Copy
c. Web pages
f. Quick Start Guides
B. Worth a thousand words: Other Media and the Technical Writer
i. Google's comic book style user manual
Lesson 9: Breaking into Technical Writing.
A. Is technical writing for you?
a. Are you good at explaining and teaching?
b. Do you love to learn?
c. Can you learn quickly?
d. Can you manage large projects?
e. Can you write clearly and plainly?
B. Degree and Certificate Programs
a. Join the STC
b. Put a profile on LinkedIN
D. Learning the Tools
a. Who's using what?
b. Studying employers' needs and software requirements
E. Building a Portfolio
a. Get your hands dirty
b. Trial software and help files
c. Floss Manuals
F. Types of jobs for technical writers
a. Full time
Lesson 11: The Tech Writer's Toolbox
b. Doc to Help
e. Blogging platforms
a. Html and css
Lesson 12: Staying in touch with the user
A. Web 2.0 and the global village
B. Meet your users
C. Setting up an maintaining a tech support blog
a. What to post?
b. How often?
c. Dirty laundry – should you publicize your company's mistakes?
d. Comments: a gold mine of user experience data
Lesson 13: Join the Community
A. The tech writer blogosphere
B. Writer River
C. Starting your own Technical Writing blog
D. Sharing knowledge – everybody wins
E. Staying on the cutting edge
Technical writing can be a skill you need from time to time in developing a product, or it can be a dynamic, rewarding profession. As technology invades every corner of our daily lives, good technical communicators will be in even greater demand.