SlideShare une entreprise Scribd logo
1  sur  19
Make every topic count in your
online help system
What kind of program is this?
• Kitchen cabinet quoting software
• Used by kitchen designers
Who is the audience?
• New
• Alone
• Bothered
• Busy
 Pushing the help button
 Using the search feature
 From a URL in an email
 From another page in the
help system
 Pushing the help button
 Using the search feature
 From a URL in an email
 From another page in the
help system
 Pushing the help button
 Using the search feature
 From a URL in an email
 From another page in the
help system
 Quick Start
 Windows
 Buttons
 Fields
Context sensitive Window topic
• Often the entry point into online help
 Anticipate the question(s) being asked
• What can I do here?
 Tasks: step by step with pictures
 Training tutorials: screens and audio
• What does this thing do? What does this thing
mean?
 Buttons and fields and screen areas
This is an example of our old style online
help.
• Task instruction buried in a wall of text.
• Functional notes given up front.
• Window graphic clicks generate popup interaction.
Task instruction buried
in a wall of text.
Functional notes given
up front.
Window graphic clicks
generate popup
interaction.
New style online help.
• What can I do? Links above page fold.
• Tasks, video, FAQ right up front.
• Expanding text replaces paragraphs of
explanation.
• Window graphic changed to Flash for hoverable
interaction.
What can I do?
Links above page fold.
Tasks, video, FAQ
right up front.
New style online help.
• What can I do? Links above page fold.
• Tasks, video, FAQ right up front.
• Expanding text replaces paragraphs of
explanation.
• Window graphic changed to Flash for hoverable
interaction.
Window graphic
changed to Flash for
hoverable interaction.
New style online help.
• What can I do? Links above page fold.
• Tasks, video, FAQ right up front.
• Expanding text replaces paragraphs of
explanation.
• Window graphic changed to Flash for hoverable
interaction.
Expanding text
replaces paragraphs
of explanation.
Buttons:
• What does it do?
• What are the results?
• Where is it found?
Fields
• What is this field?
• How do I use it?
 Where is it
updated?
 Where is it read-
only?
• What are some
examples?
• How does it relate
to other fields?
What’s next?
• How do I know if I’ve finished what I came here to
accomplish?
• How do I fix
any mistakes?
• Where do I go
next?
Software
Help button
Window topic
Task topic or Tutorial
Window topic
• Tutorial
Search
• Field definition
• Tutorial
Busy, bothered users are needy
Answer the burning question
• within a few clicks
• above the page fold
• searchably
What about your experience…
• As a writer?
• As a user?
Do you have any questions?
Read the bio
http://www.stcwdc.org/bios/dill_bio.shtml
Email
social_media@stcwdc.org
@viqui_dill https://twitter.com/viqui_dill
Linked In
http://www.linkedin.com/pub/viqui-dill/15/79/7a5
Facebook
https://www.facebook.com/viqui.dill

Contenu connexe

Plus de Viqui Dill

#STC21 Show up. Speak up. Shut up. How to be a better #a11y
#STC21 Show up. Speak up. Shut up. How to be a better #a11y #STC21 Show up. Speak up. Shut up. How to be a better #a11y
#STC21 Show up. Speak up. Shut up. How to be a better #a11y Viqui Dill
 
Show up, speak up, shut up: How to be a good ally with Viqui Dill #STC_Spectr...
Show up, speak up, shut up: How to be a good ally with Viqui Dill #STC_Spectr...Show up, speak up, shut up: How to be a good ally with Viqui Dill #STC_Spectr...
Show up, speak up, shut up: How to be a good ally with Viqui Dill #STC_Spectr...Viqui Dill
 
Show up, speak up, shut up: How to be a good ally with Viqui Dill #Conduit21 ...
Show up, speak up, shut up: How to be a good ally with Viqui Dill #Conduit21 ...Show up, speak up, shut up: How to be a good ally with Viqui Dill #Conduit21 ...
Show up, speak up, shut up: How to be a good ally with Viqui Dill #Conduit21 ...Viqui Dill
 
Show up, speak up, shut up: How to be a good ally with Viqui Dill
Show up, speak up, shut up: How to be a good ally with Viqui DillShow up, speak up, shut up: How to be a good ally with Viqui Dill
Show up, speak up, shut up: How to be a good ally with Viqui DillViqui Dill
 
Jim's Power-of-Story
Jim's Power-of-StoryJim's Power-of-Story
Jim's Power-of-StoryViqui Dill
 
Running with the bulls
Running with the bullsRunning with the bulls
Running with the bullsViqui Dill
 
#Powerofstory: the cultural program that got me clicks
#Powerofstory: the cultural program that got me clicks#Powerofstory: the cultural program that got me clicks
#Powerofstory: the cultural program that got me clicksViqui Dill
 
#PowerOfStory: the cultural program that got me clicks
#PowerOfStory: the cultural program that got me clicks#PowerOfStory: the cultural program that got me clicks
#PowerOfStory: the cultural program that got me clicksViqui Dill
 
#PowerOfStory: The cultural program that got me clicks
#PowerOfStory: The cultural program that got me clicks#PowerOfStory: The cultural program that got me clicks
#PowerOfStory: The cultural program that got me clicksViqui Dill
 
STC IDL SIG 2018 Business Meeting presentation
STC IDL SIG 2018 Business Meeting presentationSTC IDL SIG 2018 Business Meeting presentation
STC IDL SIG 2018 Business Meeting presentationViqui Dill
 
On track! Running an effective meeting is more than the agenda - Summit version
On track! Running an effective meeting is more than the agenda - Summit versionOn track! Running an effective meeting is more than the agenda - Summit version
On track! Running an effective meeting is more than the agenda - Summit versionViqui Dill
 
On track! Running an effective meeting is more than the agenda - Conduit version
On track! Running an effective meeting is more than the agenda - Conduit versionOn track! Running an effective meeting is more than the agenda - Conduit version
On track! Running an effective meeting is more than the agenda - Conduit versionViqui Dill
 
STC 2015 Summit Leadership Program
STC 2015 Summit Leadership Program STC 2015 Summit Leadership Program
STC 2015 Summit Leadership Program Viqui Dill
 
Saying Thank You. Saying I'm Sorry. When #TechComm goes all wrong
Saying Thank You. Saying I'm Sorry. When #TechComm goes all wrongSaying Thank You. Saying I'm Sorry. When #TechComm goes all wrong
Saying Thank You. Saying I'm Sorry. When #TechComm goes all wrongViqui Dill
 
Timing is everything: Tutorial Pacing
Timing is everything: Tutorial Pacing     Timing is everything: Tutorial Pacing
Timing is everything: Tutorial Pacing Viqui Dill
 
Saying Thank You. Saying I'm Sorry.
Saying Thank You. Saying I'm Sorry. Saying Thank You. Saying I'm Sorry.
Saying Thank You. Saying I'm Sorry. Viqui Dill
 
Let Me Touch It: Don’t Demo Your Training
Let Me Touch It: Don’t Demo Your TrainingLet Me Touch It: Don’t Demo Your Training
Let Me Touch It: Don’t Demo Your TrainingViqui Dill
 
Welcome to Leadership Day 2014!
Welcome to Leadership Day 2014!Welcome to Leadership Day 2014!
Welcome to Leadership Day 2014!Viqui Dill
 
Social Media Success Stories
Social Media Success Stories Social Media Success Stories
Social Media Success Stories Viqui Dill
 
Stc14 Leadership Program
Stc14 Leadership ProgramStc14 Leadership Program
Stc14 Leadership ProgramViqui Dill
 

Plus de Viqui Dill (20)

#STC21 Show up. Speak up. Shut up. How to be a better #a11y
#STC21 Show up. Speak up. Shut up. How to be a better #a11y #STC21 Show up. Speak up. Shut up. How to be a better #a11y
#STC21 Show up. Speak up. Shut up. How to be a better #a11y
 
Show up, speak up, shut up: How to be a good ally with Viqui Dill #STC_Spectr...
Show up, speak up, shut up: How to be a good ally with Viqui Dill #STC_Spectr...Show up, speak up, shut up: How to be a good ally with Viqui Dill #STC_Spectr...
Show up, speak up, shut up: How to be a good ally with Viqui Dill #STC_Spectr...
 
Show up, speak up, shut up: How to be a good ally with Viqui Dill #Conduit21 ...
Show up, speak up, shut up: How to be a good ally with Viqui Dill #Conduit21 ...Show up, speak up, shut up: How to be a good ally with Viqui Dill #Conduit21 ...
Show up, speak up, shut up: How to be a good ally with Viqui Dill #Conduit21 ...
 
Show up, speak up, shut up: How to be a good ally with Viqui Dill
Show up, speak up, shut up: How to be a good ally with Viqui DillShow up, speak up, shut up: How to be a good ally with Viqui Dill
Show up, speak up, shut up: How to be a good ally with Viqui Dill
 
Jim's Power-of-Story
Jim's Power-of-StoryJim's Power-of-Story
Jim's Power-of-Story
 
Running with the bulls
Running with the bullsRunning with the bulls
Running with the bulls
 
#Powerofstory: the cultural program that got me clicks
#Powerofstory: the cultural program that got me clicks#Powerofstory: the cultural program that got me clicks
#Powerofstory: the cultural program that got me clicks
 
#PowerOfStory: the cultural program that got me clicks
#PowerOfStory: the cultural program that got me clicks#PowerOfStory: the cultural program that got me clicks
#PowerOfStory: the cultural program that got me clicks
 
#PowerOfStory: The cultural program that got me clicks
#PowerOfStory: The cultural program that got me clicks#PowerOfStory: The cultural program that got me clicks
#PowerOfStory: The cultural program that got me clicks
 
STC IDL SIG 2018 Business Meeting presentation
STC IDL SIG 2018 Business Meeting presentationSTC IDL SIG 2018 Business Meeting presentation
STC IDL SIG 2018 Business Meeting presentation
 
On track! Running an effective meeting is more than the agenda - Summit version
On track! Running an effective meeting is more than the agenda - Summit versionOn track! Running an effective meeting is more than the agenda - Summit version
On track! Running an effective meeting is more than the agenda - Summit version
 
On track! Running an effective meeting is more than the agenda - Conduit version
On track! Running an effective meeting is more than the agenda - Conduit versionOn track! Running an effective meeting is more than the agenda - Conduit version
On track! Running an effective meeting is more than the agenda - Conduit version
 
STC 2015 Summit Leadership Program
STC 2015 Summit Leadership Program STC 2015 Summit Leadership Program
STC 2015 Summit Leadership Program
 
Saying Thank You. Saying I'm Sorry. When #TechComm goes all wrong
Saying Thank You. Saying I'm Sorry. When #TechComm goes all wrongSaying Thank You. Saying I'm Sorry. When #TechComm goes all wrong
Saying Thank You. Saying I'm Sorry. When #TechComm goes all wrong
 
Timing is everything: Tutorial Pacing
Timing is everything: Tutorial Pacing     Timing is everything: Tutorial Pacing
Timing is everything: Tutorial Pacing
 
Saying Thank You. Saying I'm Sorry.
Saying Thank You. Saying I'm Sorry. Saying Thank You. Saying I'm Sorry.
Saying Thank You. Saying I'm Sorry.
 
Let Me Touch It: Don’t Demo Your Training
Let Me Touch It: Don’t Demo Your TrainingLet Me Touch It: Don’t Demo Your Training
Let Me Touch It: Don’t Demo Your Training
 
Welcome to Leadership Day 2014!
Welcome to Leadership Day 2014!Welcome to Leadership Day 2014!
Welcome to Leadership Day 2014!
 
Social Media Success Stories
Social Media Success Stories Social Media Success Stories
Social Media Success Stories
 
Stc14 Leadership Program
Stc14 Leadership ProgramStc14 Leadership Program
Stc14 Leadership Program
 

Dernier

TeamStation AI System Report LATAM IT Salaries 2024
TeamStation AI System Report LATAM IT Salaries 2024TeamStation AI System Report LATAM IT Salaries 2024
TeamStation AI System Report LATAM IT Salaries 2024Lonnie McRorey
 
Nell’iperspazio con Rocket: il Framework Web di Rust!
Nell’iperspazio con Rocket: il Framework Web di Rust!Nell’iperspazio con Rocket: il Framework Web di Rust!
Nell’iperspazio con Rocket: il Framework Web di Rust!Commit University
 
Passkey Providers and Enabling Portability: FIDO Paris Seminar.pptx
Passkey Providers and Enabling Portability: FIDO Paris Seminar.pptxPasskey Providers and Enabling Portability: FIDO Paris Seminar.pptx
Passkey Providers and Enabling Portability: FIDO Paris Seminar.pptxLoriGlavin3
 
A Deep Dive on Passkeys: FIDO Paris Seminar.pptx
A Deep Dive on Passkeys: FIDO Paris Seminar.pptxA Deep Dive on Passkeys: FIDO Paris Seminar.pptx
A Deep Dive on Passkeys: FIDO Paris Seminar.pptxLoriGlavin3
 
"ML in Production",Oleksandr Bagan
"ML in Production",Oleksandr Bagan"ML in Production",Oleksandr Bagan
"ML in Production",Oleksandr BaganFwdays
 
Sample pptx for embedding into website for demo
Sample pptx for embedding into website for demoSample pptx for embedding into website for demo
Sample pptx for embedding into website for demoHarshalMandlekar2
 
How to write a Business Continuity Plan
How to write a Business Continuity PlanHow to write a Business Continuity Plan
How to write a Business Continuity PlanDatabarracks
 
DevEX - reference for building teams, processes, and platforms
DevEX - reference for building teams, processes, and platformsDevEX - reference for building teams, processes, and platforms
DevEX - reference for building teams, processes, and platformsSergiu Bodiu
 
Anypoint Exchange: It’s Not Just a Repo!
Anypoint Exchange: It’s Not Just a Repo!Anypoint Exchange: It’s Not Just a Repo!
Anypoint Exchange: It’s Not Just a Repo!Manik S Magar
 
Merck Moving Beyond Passwords: FIDO Paris Seminar.pptx
Merck Moving Beyond Passwords: FIDO Paris Seminar.pptxMerck Moving Beyond Passwords: FIDO Paris Seminar.pptx
Merck Moving Beyond Passwords: FIDO Paris Seminar.pptxLoriGlavin3
 
Developer Data Modeling Mistakes: From Postgres to NoSQL
Developer Data Modeling Mistakes: From Postgres to NoSQLDeveloper Data Modeling Mistakes: From Postgres to NoSQL
Developer Data Modeling Mistakes: From Postgres to NoSQLScyllaDB
 
From Family Reminiscence to Scholarly Archive .
From Family Reminiscence to Scholarly Archive .From Family Reminiscence to Scholarly Archive .
From Family Reminiscence to Scholarly Archive .Alan Dix
 
The Fit for Passkeys for Employee and Consumer Sign-ins: FIDO Paris Seminar.pptx
The Fit for Passkeys for Employee and Consumer Sign-ins: FIDO Paris Seminar.pptxThe Fit for Passkeys for Employee and Consumer Sign-ins: FIDO Paris Seminar.pptx
The Fit for Passkeys for Employee and Consumer Sign-ins: FIDO Paris Seminar.pptxLoriGlavin3
 
Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024BookNet Canada
 
"Debugging python applications inside k8s environment", Andrii Soldatenko
"Debugging python applications inside k8s environment", Andrii Soldatenko"Debugging python applications inside k8s environment", Andrii Soldatenko
"Debugging python applications inside k8s environment", Andrii SoldatenkoFwdays
 
How AI, OpenAI, and ChatGPT impact business and software.
How AI, OpenAI, and ChatGPT impact business and software.How AI, OpenAI, and ChatGPT impact business and software.
How AI, OpenAI, and ChatGPT impact business and software.Curtis Poe
 
Dev Dives: Streamline document processing with UiPath Studio Web
Dev Dives: Streamline document processing with UiPath Studio WebDev Dives: Streamline document processing with UiPath Studio Web
Dev Dives: Streamline document processing with UiPath Studio WebUiPathCommunity
 
Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024BookNet Canada
 
Artificial intelligence in cctv survelliance.pptx
Artificial intelligence in cctv survelliance.pptxArtificial intelligence in cctv survelliance.pptx
Artificial intelligence in cctv survelliance.pptxhariprasad279825
 
DSPy a system for AI to Write Prompts and Do Fine Tuning
DSPy a system for AI to Write Prompts and Do Fine TuningDSPy a system for AI to Write Prompts and Do Fine Tuning
DSPy a system for AI to Write Prompts and Do Fine TuningLars Bell
 

Dernier (20)

TeamStation AI System Report LATAM IT Salaries 2024
TeamStation AI System Report LATAM IT Salaries 2024TeamStation AI System Report LATAM IT Salaries 2024
TeamStation AI System Report LATAM IT Salaries 2024
 
Nell’iperspazio con Rocket: il Framework Web di Rust!
Nell’iperspazio con Rocket: il Framework Web di Rust!Nell’iperspazio con Rocket: il Framework Web di Rust!
Nell’iperspazio con Rocket: il Framework Web di Rust!
 
Passkey Providers and Enabling Portability: FIDO Paris Seminar.pptx
Passkey Providers and Enabling Portability: FIDO Paris Seminar.pptxPasskey Providers and Enabling Portability: FIDO Paris Seminar.pptx
Passkey Providers and Enabling Portability: FIDO Paris Seminar.pptx
 
A Deep Dive on Passkeys: FIDO Paris Seminar.pptx
A Deep Dive on Passkeys: FIDO Paris Seminar.pptxA Deep Dive on Passkeys: FIDO Paris Seminar.pptx
A Deep Dive on Passkeys: FIDO Paris Seminar.pptx
 
"ML in Production",Oleksandr Bagan
"ML in Production",Oleksandr Bagan"ML in Production",Oleksandr Bagan
"ML in Production",Oleksandr Bagan
 
Sample pptx for embedding into website for demo
Sample pptx for embedding into website for demoSample pptx for embedding into website for demo
Sample pptx for embedding into website for demo
 
How to write a Business Continuity Plan
How to write a Business Continuity PlanHow to write a Business Continuity Plan
How to write a Business Continuity Plan
 
DevEX - reference for building teams, processes, and platforms
DevEX - reference for building teams, processes, and platformsDevEX - reference for building teams, processes, and platforms
DevEX - reference for building teams, processes, and platforms
 
Anypoint Exchange: It’s Not Just a Repo!
Anypoint Exchange: It’s Not Just a Repo!Anypoint Exchange: It’s Not Just a Repo!
Anypoint Exchange: It’s Not Just a Repo!
 
Merck Moving Beyond Passwords: FIDO Paris Seminar.pptx
Merck Moving Beyond Passwords: FIDO Paris Seminar.pptxMerck Moving Beyond Passwords: FIDO Paris Seminar.pptx
Merck Moving Beyond Passwords: FIDO Paris Seminar.pptx
 
Developer Data Modeling Mistakes: From Postgres to NoSQL
Developer Data Modeling Mistakes: From Postgres to NoSQLDeveloper Data Modeling Mistakes: From Postgres to NoSQL
Developer Data Modeling Mistakes: From Postgres to NoSQL
 
From Family Reminiscence to Scholarly Archive .
From Family Reminiscence to Scholarly Archive .From Family Reminiscence to Scholarly Archive .
From Family Reminiscence to Scholarly Archive .
 
The Fit for Passkeys for Employee and Consumer Sign-ins: FIDO Paris Seminar.pptx
The Fit for Passkeys for Employee and Consumer Sign-ins: FIDO Paris Seminar.pptxThe Fit for Passkeys for Employee and Consumer Sign-ins: FIDO Paris Seminar.pptx
The Fit for Passkeys for Employee and Consumer Sign-ins: FIDO Paris Seminar.pptx
 
Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024
 
"Debugging python applications inside k8s environment", Andrii Soldatenko
"Debugging python applications inside k8s environment", Andrii Soldatenko"Debugging python applications inside k8s environment", Andrii Soldatenko
"Debugging python applications inside k8s environment", Andrii Soldatenko
 
How AI, OpenAI, and ChatGPT impact business and software.
How AI, OpenAI, and ChatGPT impact business and software.How AI, OpenAI, and ChatGPT impact business and software.
How AI, OpenAI, and ChatGPT impact business and software.
 
Dev Dives: Streamline document processing with UiPath Studio Web
Dev Dives: Streamline document processing with UiPath Studio WebDev Dives: Streamline document processing with UiPath Studio Web
Dev Dives: Streamline document processing with UiPath Studio Web
 
Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
 
Artificial intelligence in cctv survelliance.pptx
Artificial intelligence in cctv survelliance.pptxArtificial intelligence in cctv survelliance.pptx
Artificial intelligence in cctv survelliance.pptx
 
DSPy a system for AI to Write Prompts and Do Fine Tuning
DSPy a system for AI to Write Prompts and Do Fine TuningDSPy a system for AI to Write Prompts and Do Fine Tuning
DSPy a system for AI to Write Prompts and Do Fine Tuning
 

Every topic is page one

  • 1. Make every topic count in your online help system
  • 2. What kind of program is this? • Kitchen cabinet quoting software • Used by kitchen designers
  • 3. Who is the audience? • New • Alone • Bothered • Busy
  • 4.  Pushing the help button  Using the search feature  From a URL in an email  From another page in the help system
  • 5.  Pushing the help button  Using the search feature  From a URL in an email  From another page in the help system
  • 6.  Pushing the help button  Using the search feature  From a URL in an email  From another page in the help system
  • 7.  Quick Start  Windows  Buttons  Fields
  • 8. Context sensitive Window topic • Often the entry point into online help  Anticipate the question(s) being asked • What can I do here?  Tasks: step by step with pictures  Training tutorials: screens and audio • What does this thing do? What does this thing mean?  Buttons and fields and screen areas
  • 9. This is an example of our old style online help. • Task instruction buried in a wall of text. • Functional notes given up front. • Window graphic clicks generate popup interaction. Task instruction buried in a wall of text. Functional notes given up front. Window graphic clicks generate popup interaction.
  • 10. New style online help. • What can I do? Links above page fold. • Tasks, video, FAQ right up front. • Expanding text replaces paragraphs of explanation. • Window graphic changed to Flash for hoverable interaction. What can I do? Links above page fold. Tasks, video, FAQ right up front.
  • 11. New style online help. • What can I do? Links above page fold. • Tasks, video, FAQ right up front. • Expanding text replaces paragraphs of explanation. • Window graphic changed to Flash for hoverable interaction. Window graphic changed to Flash for hoverable interaction.
  • 12. New style online help. • What can I do? Links above page fold. • Tasks, video, FAQ right up front. • Expanding text replaces paragraphs of explanation. • Window graphic changed to Flash for hoverable interaction. Expanding text replaces paragraphs of explanation.
  • 13. Buttons: • What does it do? • What are the results? • Where is it found?
  • 14. Fields • What is this field? • How do I use it?  Where is it updated?  Where is it read- only? • What are some examples? • How does it relate to other fields?
  • 15. What’s next? • How do I know if I’ve finished what I came here to accomplish? • How do I fix any mistakes? • Where do I go next?
  • 17. Window topic • Tutorial Search • Field definition • Tutorial
  • 18. Busy, bothered users are needy Answer the burning question • within a few clicks • above the page fold • searchably What about your experience… • As a writer? • As a user? Do you have any questions?
  • 19. Read the bio http://www.stcwdc.org/bios/dill_bio.shtml Email social_media@stcwdc.org @viqui_dill https://twitter.com/viqui_dill Linked In http://www.linkedin.com/pub/viqui-dill/15/79/7a5 Facebook https://www.facebook.com/viqui.dill

Notes de l'éditeur

  1. Every online help topic is Page One. Make every topic count in your online help system. Every topic in your online help system could be page one. No matter what kind of topic you create (window, task, button, or field definition), help users find quick answers to common questions. http://lanyrd.com/scfpkq http://www.slideshare.net/viqui_dill/every-topic-is-page-one
  2. So you’re about to make new online help for an audience of folks who want to learn how to use a brand new system. If you’re like me, you may never get to meet the actual users. My company makes kitchen cabinets, which you can buy online. It’s really hard to buy a whole kitchen worth of cabinets and if you make a mistake, it’s usually a very costly and sometimes embarrassing mistake. My users are kitchen designers who take the home owner’s input and measurements and turn the home owner’s dream into a design and a list of parts to order for the kitchen. They will need to order everything from the cabinets themselves on down to the decorative handles and functional accessories like the wine rack and slide out trash bin.
  3. I always assume that any user who is desperate enough to go to the online help is 3 things:New – they are new at the system and they want reassurance that it will be worth their time to use it. Alone – they are working alone at the moment, otherwise they would have just asked a coworker the question. Bothered – they are either angry, or scared, or both. Busy — this goes without saying. Users are trying to get the job done, buying cabinets – not surfing around looking for the right button. Whatever I offer them in my tutorials and online help, I have to be complete and accurate. I have to gain the trust of my audience and reassure them that no matter what the task is, they can do it if they just hang in with me and follow my instructions. OK, so that’s who will do the reading and searching and learning. Since these folks don’t work for my company, I have no prayer of ever meeting them. Who will I be working with while I’m creating the help? Who will tell me what’s involved in each process? Who will give the final approval when I’m done? I will be working with the IT folks who have designed the system for the designers to use. These guys and gals already know how to use the system. They will already know how to do each task. They will already know the answer to every question. They will be more concerned with accuracy and completeness of the content than with the effectiveness of the delivery. They will have very little patience for material that tries to teach them what they already know. So I have to be able to build a bridge from what the SMEs, Developers, and maybe even the Marketing folks tell me to the actual needs of the actual users of the system.
  4. This is the main screen for Quest III, our quoting and estimating software. Doesn’t look much like a kitchen, does it? But it’s really a kitchen and a bathroom.
  5. This is the Quick Start page for the Quest III online help system. If you click the help button on the main screen, this is what you see.
  6. For any type of topic, consider how the viewer go there. Did they push the help button? They are at the context sensitive window topic. Did they use the search feature in the help system? They are at the field or button topic. Did someone send them the URL as an email? They may be at the task topic or What’s New topic. Did another help topic direct them there? They may be at a task or tutorial topic. What is the question in their mind? Try to answer the question as quickly as possible.
  7. Window topic is usually page 1, opened when they click the help button on a specific window. Quick Start topic could be page 1, opened when they click the help button on the main MDI. Button and field topics are often what they really want to see, but are buried inside the help system. Video or Task topic is usually page 2, sent from a window topic or from a link in an email from a human being.
  8. This is an example of our old style online help. Task instruction buried in a wall of text. Functional notes given up front. Window graphic clicks generate popup interaction.
  9. This is an example of our new style online help. This is the topic that goes with the screen for picking out door styles. What can I do? Links above page fold. Tasks, video, FAQ right up front. Expanding text replaces paragraphs of explanation. Window graphic changed to Flash for hoverable interaction.
  10. This is the topic that goes with the screen for picking out door styles. What can I do? Links above page fold. Tasks, video, FAQ right up front. Expanding text replaces paragraphs of explanation. Window graphic changed to Flash for hoverable interaction.
  11. This is the topic that goes with the screen for picking out door styles. What can I do? Links above page fold. Tasks, video, FAQ right up front. Expanding text replaces paragraphs of explanation. Window graphic changed to Flash for hoverable interaction.
  12. Page one leads to the answer. If you start at the window, by clicking the help button in the program itself, you will find the tutorial right away. If you start someplace else and do a search, you will find the field definition, which will lead you to the tutorial right away.
  13. Page one leads to the answer. If you start at the window, by clicking the help button in the program itself, you will find the tutorial right away. If you start someplace else and do a search, you will find the field definition, which will lead you to the tutorial right away.
  14. Viqui would love to connect with you. Email her at social_media@stcwdc.org, follow her on twitter @viqui_dillhttps://twitter.com/viqui_dill, connect with her on Linked In http://www.linkedin.com/pub/viqui-dill/15/79/7a5, or make her your friend on Facebook https://www.facebook.com/viqui.dill.