the diagnosis-resolution structure in troubleshooting procedures david k. farkas dept. of human...
Post on 19-Dec-2015
214 views
TRANSCRIPT
![Page 1: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/1.jpg)
The Diagnosis-Resolution Structure in Troubleshooting Procedures
David K . FarkasDept. of Human Centered Design & EngineeringUniversity of WashingtonSeattle, Washington, USAhttp://faculty.washington.edu/farkas/[email protected]
![Page 2: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/2.jpg)
Big idea
• Troubleshooting procedures always exhibit a diagnosis-resolution structure
• Understanding this structure leads to important insights for design
2
![Page 3: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/3.jpg)
Presentation vs. proceedings paper
• Proceedings paper has more depth• Presentation has more illustrations and explicit
guidelines
• The presentation slides are available here:http://faculty.washington.edu/farkas/IPCC.pptx
3
![Page 4: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/4.jpg)
Acknowledgments
• Connie Olberg (formerly) at Microsoft and her user support team
4
![Page 5: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/5.jpg)
Background:What Are Troubleshooting Procedures?
![Page 6: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/6.jpg)
Troubleshooting content is problem focused
Is this your problem?Here is how to fix it.
6
Problem = Symptom
![Page 7: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/7.jpg)
Similar to medical diagnosis and treatment
• Similar to a doctor asking a patient to describe symptoms and then indicating treatment
• Even more similar to a first-aid manual
7
![Page 8: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/8.jpg)
In most cases this problem is a bug, incompatibility, or component failure
8
EZGrab 3.0 freezes or closes unexpectedly
My computer no longer plays audio or produces any sound from the speakers or headset
![Page 9: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/9.jpg)
TPs are written for . . .
• Support Centers/KBs (Knowledge Bases)
• Help systems and manuals• Forum posts• Etc.
9
![Page 10: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/10.jpg)
Simple TP in a small support center
10
![Page 11: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/11.jpg)
Usually, TPs are more challenging to design and write than standard procedures
![Page 12: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/12.jpg)
Complex TP from an Adobe Acrobat support center article on printing problems (excerpt)
12
![Page 13: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/13.jpg)
Some problems can be handled by remote intervention
13
![Page 14: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/14.jpg)
Forums are an alternative to TPs
2/20/09 6:17 pmTony: I used to be able to open two different ppt files in different windows. But somehow when I open the file it shows up in only one window.
2/20/09 11:46 pmMike MVP: Open both your presentations, then select the View Tab, Arrange All. Always a good idea to mention which version of PowerPoint your using.
2/21/09 8:46 pmTony: Maybe you misunderstand what I meant. I mean that when you open two ppt files, the screen will show . . .
![Page 15: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/15.jpg)
The Diagnosis-Resolution Structure:The Diagnosis Phase
![Page 16: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/16.jpg)
TPs always exhibit a diagnosis-resolution structure: Simplest case
M
Title
Explains method
Describes symptomDiagnosis phase
Resolution phase
16
![Page 17: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/17.jpg)
Possible causes with their own specific symptoms:
Browser settingsRouter problemsFirewall settingsWi-Fi Internet connection problemsParental control softwareService is downOlder version of client software
More complex problems will exhibit multiple symptoms
Title
17
I cannot connect to the service
![Page 18: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/18.jpg)
Dia
gnos
is ph
ase
Multiple symptoms in a flat list
S S S S
Title
Specific symptoms
Broad symptom
18
I cannot connect to the service
![Page 19: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/19.jpg)
Tree of symptomsD
iagn
osis
ph
ase
S
S S
S
S S
Title
More specific symptoms
Broad symptom
Still more specific symptoms
19
![Page 20: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/20.jpg)
Tree of symptoms
Statements of symptoms
S
S
S
S
20
“I am having trouble with my modem”
=
![Page 21: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/21.jpg)
Isolating the cause
More specific statements of symptoms
S
S
S
21
![Page 22: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/22.jpg)
Identifying a successful method—we hope
M
22
![Page 23: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/23.jpg)
The Diagnosis-Resolution Structure: The Resolution Phase
![Page 24: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/24.jpg)
Key distinction: Method vs. solution path
• Method: A single procedure intended to solve a problem
• Solution path: A broader approach to solving a problem, usually consisting of several related methods
24
M M M P=
![Page 25: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/25.jpg)
A solution path consisting of multiple methods(fixed sequence)
M
M
Contact your system administrator
MJ
J
J
Res
olut
ion
phas
e
25
![Page 26: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/26.jpg)
A solution path consisting of multiple methods(variable sequence)
M
M
MJ
J
J
Res
olut
ion
phas
e
26
![Page 27: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/27.jpg)
Res
olut
ion
phas
eA solution path consisting of multiple methods(fixed sequence)
M M
M
JJ
J
M M
M
JJ
J
M M
M
JJ
J
27
![Page 28: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/28.jpg)
Res
olut
ion
phas
eA solution path consisting of multiple methods(variable sequence)
M M
M
JJ
J
M M
M
JJ
J
M M
M
JJ
J
28
![Page 29: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/29.jpg)
You can empower users to choose solution path based on their own priorities
P Path splits with user decision
P P
29
![Page 30: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/30.jpg)
Guidelines: 1. General guidelines2. Guidelines from diagnosis-resolution structure
![Page 31: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/31.jpg)
General guidelines (tech comm, instructional design, etc.)
• To minimize expenditure of time and effort, strive for clarity, brevity, etc
• To minimize user’s risk of failure, provide sufficient information, accurate information, etc
• To motivate users to attempt and stick with TPs, strive for an unintimidating appearance and offer encouragement
31
![Page 32: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/32.jpg)
Example: Motivating users at the outset of a TP
32
This method has a high probability of success. It is lengthy but easy to follow.
![Page 33: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/33.jpg)
Guidelines: 1. General guidelines2. Five guidelines from diagnosis-resolution structure
![Page 34: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/34.jpg)
Users must be to identify the TP that applies to their problem
• Phrase titles and symptom descriptions carefully (at audience’s level)
• Error messages are excellent symptoms, especially when they are specific to a particular problem
• Sometimes you need two articles, each articulating a different symptom
34
![Page 35: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/35.jpg)
Be wary of titles that express causation
The application will not initialize
35
![Page 36: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/36.jpg)
Two titles, each describing very different symptoms of the same problem
The status light sometimes flashes red
36
My connection speed is sometimes very slow
![Page 37: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/37.jpg)
Strive for a specific understanding of the problem
• The more you know about the problem, the simpler the resolution phase
37
![Page 38: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/38.jpg)
Favor variables sequences. Favor user empowerment.
• When possible, bypass methods and solution paths that won’t work
• When possible, allow the user to choose a solution path that meets their particular needs
38
![Page 39: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/39.jpg)
Decide how deeply to explain the cause of the problem
• Most users don’t care about the cause• When user actions brought on the problem, it is
necessary to explain how to prevent a recurrence
39
![Page 40: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/40.jpg)
Be wary of very difficult methods. Be wary of too many methods
• Lengthy procedures and articles are demotivators • Difficult methods are demotivators
– Recognize the law of diminishing returns– When appropriate, hand off to live support, etc
40
![Page 41: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/41.jpg)
TPs will remain important
• User’s often need assistance • Vendor is often the best or only source of reliable
information
• Finding a balance:– Crafted content– Remote intervention– Users helping users
41
![Page 42: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/42.jpg)
Thank you
42
![Page 43: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/43.jpg)
Forum content may not be well crafted
![Page 44: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/44.jpg)
Complex TP from a Microsoft KB article (excerpt)
44
![Page 45: The Diagnosis-Resolution Structure in Troubleshooting Procedures David K. Farkas Dept. of Human Centered Design & Engineering University of Washington](https://reader030.vdocument.in/reader030/viewer/2022032703/56649d2e5503460f94a05341/html5/thumbnails/45.jpg)
The complete KB article
45