Technical Writing Flashcards

1
Q

In this order, good technical documentation should be:

A

Correct –> Complete –> Usable –> Clear –> Consistent

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
2
Q

What is an SME?

A

Subject Matter Expert, used as a resource to gather technical information

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
3
Q

Being an excellent technical writer requires you to be like what profession?

A

Investigative journalist

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
4
Q

What are the five steps of technical writing?

A
Plan
Structure
Write
Review
Publish
How well did you know this?
1
Not at all
2
3
4
5
Perfectly
5
Q

What should you fill out before writing a technical document?

A

A Technical Brief

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
6
Q

According to the Microsoft Manual of Style, how can you be inspirational?

A

By emphasizing what a user can do rather than what they can’t do.

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
7
Q

What must you let go of when writing technical documentation?

A

Your Ego

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
8
Q

What should you have an in-depth understanding of to write effective technical documentation?

A

Your readers

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
9
Q

In what order should you plan your production schedule?

A

Backwards

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
10
Q

What should you get to know intimately?

A

Your product

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
11
Q

What is the most difficult part of writing a draft?

A

Getting started

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
12
Q

What section should you start with when writing a document?

A

The easiest

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
13
Q

Why should you stop proofreading?

A
  • 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
How well did you know this?
1
Not at all
2
3
4
5
Perfectly