Technical Writing Flashcards
In this order, good technical documentation should be:
Correct –> Complete –> Usable –> Clear –> Consistent
What is an SME?
Subject Matter Expert, used as a resource to gather technical information
Being an excellent technical writer requires you to be like what profession?
Investigative journalist
What are the five steps of technical writing?
Plan Structure Write Review Publish
What should you fill out before writing a technical document?
A Technical Brief
According to the Microsoft Manual of Style, how can you be inspirational?
By emphasizing what a user can do rather than what they can’t do.
What must you let go of when writing technical documentation?
Your Ego
What should you have an in-depth understanding of to write effective technical documentation?
Your readers
In what order should you plan your production schedule?
Backwards
What should you get to know intimately?
Your product
What is the most difficult part of writing a draft?
Getting started
What section should you start with when writing a document?
The easiest
Why should you stop proofreading?
- When you start nitpicking about insignificant words
- You revise the revision of the revision of the revision
- You can’t stand to look at the document one more time