Creating a Troubleshooting Guide Whats wrong with these sentences? - - PowerPoint PPT Presentation

Creating a Troubleshooting Guide

What’s wrong with these sentences?

• 1. Secretaries are responsible for taking

dictation, answering phone calls, and the coffee.

• 2. Please send the following information:

a) How do you transport the vehicles to the salesroom b) Average number of test drives before the vehicle is sold c) Deciding the percentage to go to sales representatives Non-parallel grammar

What’s wrong with these sentences?

• Giant Waves Down Queen Mary’s Funnel
• Squad Helps Dog Bite Victim
• McDonald’s Fries Holy Grail for Potato

Farmers

• Vegetarian Fed Hens

Telegraphic style aka “ugg speak”

What’s wrong with these headings?

The camera Lens is Scratched. The Phone Won’t turn on. The Nintendo logo has rubbed

• ff.

Solution 1 Use sentence case: Capitalize first letter and proper nouns only.

The camera lens is scratched. The phone won’t turn on. The Nintendo logo has rubbed off.

Inconsistent capitalization

What’s wrong with these headings?

The camera Lens is Scratched. The Phone Won’t turn on. The Nintendo logo has rubbed

• ff.

Solution 2 Use title case: Capitalize everything except

• articles

a, an, the

• conjunctions

and, or, but, etc.

• prepositions
• n, over, by,

to, etc.

The Camera Lens Is Scratched. The Phone Won’t Turn on. The Nintendo Logo Has Rubbed off.

Use correct phrasing.

Problem Causes Solutions

Phrased as problem Specifically described Suggested, but not yet described —link to the repair guide Incorrect: Exposure Incorrect: Lighting Incorrect: Remove the old light by

• twisting. . .

Correct: Underexposed photos Correct: Insufficient lighting Correct: You may need to replace the light.

Check the list grammar:

Problems Causes

Use headings correctly.

Include text under each heading.

Heading

Text

Heading

Text

Use headings correctly.

Ensure the text makes sense without reference to the heading—use topic sentences under each heading.

No!

Yes!

And avoid "naked this".

Check the list grammar:

Fix parallelism Repair telegraphic style

Check for the following:

• Links to at least 5 different hardware

repair guides.

• Grammatical consistency in the table of

contents, headings, and subheadings.

• Consistent capitalization.
• Text under all headings.
• Avoidance of telegraphic style.
• Topic sentences under ALL headings.