SlideShare a Scribd company logo
Optimizing the User Experience Through Integrated Information Design Sowmini Sampath and Richard Ellis
What We’ll Be Talking About In this talk, we’ll describe our approach to developing help solutions that:  Integrate context sensitive help (CSH) into product user interfaces  Integrate CSH with our existing knowledge base Derive content from interaction analysis
The MathWorks Products The MathWorks produces software for engineers and researchers in a variety of industries: Automotive Electronics Industrial equipment  Telecommunications
How People Use Our Products? Users create computer models  Run simulations  Perform data analysis and visualization Create new tools and applications using our software.
 
 
Task Complexity User tasks often require configuring a number of complex dialogs. Each element represents a decision that the user must make.
Designing Help for Graphical User Interfaces (GUIs) Increasing use of GUIs by products required better help design Design goals:  Integrate user assistance into product interfaces. Provide targeted information for each decision Make CSH an entry point into the existing user documentation.
Initial Investigations Needed to partner with engineers to integrate the help into the interface. Many people thought context sensitive help was of little value. Why had people rarely found it useful?
What Was Not Working Tooltips were often used to provide scant information Help button dove into usage topics and often required you to wade through a pool information to find the answer.
Why it Was Not Working Tooltips lack: Enough information Linking Formatting Not persistent  Help browser: Overwhelming amount of information Deep hierarchy of information Is cumbersome – starting another application Need to provide the right amount and type of information.
Analysis of User Help Requirements We developed use cases, observed usability test, and brainstormed to develop a model of user information needs. A “critical mass” of information necessary. A progression from specific details to general concepts – information escalation. Avoid quantum leaps in your information escalation path.
User Interactions We Support with Help New users tend to explore before doing actual work. Users need to map their task onto the products features Experienced users often wanted to be reminded of details.  All users wanted unobtrusive, on-demand information.
The On Ramp – Provided by Help Button  Purpose High-level workflow Information gateway
Field-Level Help Right-click context menu displays a popup window with help on individual item. Purpose Relevant details Link to related information
Embedding Help in the User Interface Application starts with instructions displayed Start by doing this Built in on ramp
Procedures Update as Work Progresses The help always matches the tool’s current state. Close help pane GUI has reconfigured Help automatically updates
Tying It All Together A well planned information escalation path – information must stay in context.  We know what users are doing because they have requested help from a particular location in a GUI.  Through task analysis the writer has determined what supporting information needs to be in the user’s manual. Our metaphor – the link opens the user’s manual at just the right page.
The CSH model integrates all help CSH becomes an entry point into our knowledge base User tasks Product workflow
Introduction Brief description of the SimBiology® application Challenges posed to the writing team by the software Implementation of the solution Summary
SimBiology® SimBiology is a product from the MathWorks that lets biologists visualize and analyze biochemical reactions. The SimBiology application extends MATLAB® for use by scientists in academia, and in the biotech and pharmaceutical industry.
Interface Description
How to Begin? We started by analyzing the user’s workflow: Took a user’s task and mapped it out in the SimBiology GUI Created task scenarios and did usability testing Noted user interactions with the GUI to help drive the design process Observed that there were many sub tasks within the overall workflow
Selecting a Solution Selected embedded procedures as the solution to documenting subtasks
 
 
Observation Novice user asks “Where do I begin? Having these multiple tasks confront the user posed a different challenge:  Users may not know what they need before and what they must do after in the overall workflow.
Solution Provide an on-ramp to the GUI Provide an overall view of the general workflow, and show how to map tasks to product features
 
Research Workflow
SimBiology User Workflow
Process of Creating the Diagram Helped us conceptualize the workflow  Learned about user task scenarios Help us understand what information the target audience needs
Observation Experienced users require more in-depth information but want this in the context of their task.
Solution A path to more in depth information that is closely related to users’ tasks – information must stay in context or users do not read it.
 
Summary of SimBiology Help SimBiology documentation includes: Embedded-help pane Procedures to accomplish typical tasks in the GUI Cross-references to supporting information Usage Topics An overall view of the general workflow, and how to map tasks to product features In-depth information – conceptual topics, tutorials, reference materials with lots of examples
CSH becomes an entry point into our information system Conceptual topics Tutorials Reference

More Related Content

PPT
DITA: Managing It All
PPT
Dynamic Product Documentation
PPT
Critical Success Factors: Separating Fact from Fantasy
PDF
Beyond the web: Customer service content strategy
PPT
Select, Implement and Deploy Enterprise Learning Applications
PDF
SLBdiensten XP sessie: presentatie Microsoft Services
PPT
Deirdra dwyer
PDF
Corp Training All
DITA: Managing It All
Dynamic Product Documentation
Critical Success Factors: Separating Fact from Fantasy
Beyond the web: Customer service content strategy
Select, Implement and Deploy Enterprise Learning Applications
SLBdiensten XP sessie: presentatie Microsoft Services
Deirdra dwyer
Corp Training All

What's hot (20)

PPTX
Developing Workflow-Based Help
PPTX
DMC: Use Microsoft SharePoint Technology You Already Own to Operate Efficient...
PPTX
Implement an enterprise service bus revised
PPTX
Agile Software Development
PDF
Changing culture through revolving doors program @ Deluxe
PPTX
Scrum Bangalore 16th Meetup - March 5, 2016 - Replicating Architectural Scali...
PPT
Hwsbpi Presentation01
PPTX
SharePoint Workflow 2011
PPTX
Enhancements and Features for Office 2007
PPT
Application Migration using the Accelerated Delivery Platform
PPTX
Implementing SharePoint 2010 Projects
PPT
Application Migration Using The Accelerated Delivery Platform
PPT
Share Point Project Management
PPT
Ovum Information Management and Collaboration event
PDF
Enterprise Mailroom Process Improvement Q&A
PDF
Role of Business Analysis in Modern Project Management
PPT
CustomerVision Overview May2006
PPT
Create and Maintain Scrum (Alexandre Boutin)
PPT
Making The Most Of Work Site Environment (Ilta Webinar 9 28 From Baker Robbin...
PDF
Gridle infodeck for teams and enterprises
Developing Workflow-Based Help
DMC: Use Microsoft SharePoint Technology You Already Own to Operate Efficient...
Implement an enterprise service bus revised
Agile Software Development
Changing culture through revolving doors program @ Deluxe
Scrum Bangalore 16th Meetup - March 5, 2016 - Replicating Architectural Scali...
Hwsbpi Presentation01
SharePoint Workflow 2011
Enhancements and Features for Office 2007
Application Migration using the Accelerated Delivery Platform
Implementing SharePoint 2010 Projects
Application Migration Using The Accelerated Delivery Platform
Share Point Project Management
Ovum Information Management and Collaboration event
Enterprise Mailroom Process Improvement Q&A
Role of Business Analysis in Modern Project Management
CustomerVision Overview May2006
Create and Maintain Scrum (Alexandre Boutin)
Making The Most Of Work Site Environment (Ilta Webinar 9 28 From Baker Robbin...
Gridle infodeck for teams and enterprises
Ad

Viewers also liked (20)

KEY
COMPLETE STREETS in FRANKLIN, WI
PPTX
Css class 17 multimodal options 112309
PPT
Statewide Context for Local Street Design
PPTX
Css class 18 placemaking 120309
PPTX
Css class 26 using css in practice 113009
PPTX
Interactive Design of Urban Spaces using Geometrical and Behavioral Modeling
PPTX
Presentation1
PPTX
Street Design Guidelines
PDF
Improving Street Design Through 'Link and Place'
PPTX
Woocommerce
PPTX
Css slide template 111609
DOC
Syllabus css course - 10 weeks 022309
PPTX
Css classes 27 28 - term project presentations 100410
PPT
Complete Streets, Complete Places
PPT
Street Design guidelines UTTIPEC 2011-printer-friendly
DOCX
Athena: Báo cáo thực tập đề tài wordpress
PDF
Manual for streets 2
PDF
Roadspace Allocation for Better Streets
PPTX
Road types and Road networks
DOCX
[Athena]Nghiên Cứu Và Xây Dựng Website Bằng Wordpress
COMPLETE STREETS in FRANKLIN, WI
Css class 17 multimodal options 112309
Statewide Context for Local Street Design
Css class 18 placemaking 120309
Css class 26 using css in practice 113009
Interactive Design of Urban Spaces using Geometrical and Behavioral Modeling
Presentation1
Street Design Guidelines
Improving Street Design Through 'Link and Place'
Woocommerce
Css slide template 111609
Syllabus css course - 10 weeks 022309
Css classes 27 28 - term project presentations 100410
Complete Streets, Complete Places
Street Design guidelines UTTIPEC 2011-printer-friendly
Athena: Báo cáo thực tập đề tài wordpress
Manual for streets 2
Roadspace Allocation for Better Streets
Road types and Road networks
[Athena]Nghiên Cứu Và Xây Dựng Website Bằng Wordpress
Ad

Similar to Optimizing The User Experience Through Integrated Information Design (20)

PDF
Task Orientation BSIT 6th .pdf
PPT
Ucd Techniques - Shad MUN 2008
PPT
UCD Workshop - Shad MUN 2008
PPT
From Use to User Interface
PPTX
Designing a good digital experience - PDA Europe Virtual Conference 2020
PPSX
Majestic MRSS Usability Engineering
DOCX
College Management System project
PPTX
UXBASIS – Getting UX integrated
PPT
MMRSS Usability Engineering
PPTX
Things you should know before you build your site
PDF
Bridging Current Reality & Future Vision with Reality Maps
PDF
Heuristics Evaluation - How to Guide.pdf
PDF
Heuristics Evaluation - How to Guide.pdf
PDF
Basics of-usability-testing
PPTX
Integrating User Centered Design with Agile Development
PPT
Web Engineering
PPT
User Experience & Design…Designing for others…UED
PDF
online news portal system
PDF
Design process
PPTX
How technical writers can contribute to the user experience
Task Orientation BSIT 6th .pdf
Ucd Techniques - Shad MUN 2008
UCD Workshop - Shad MUN 2008
From Use to User Interface
Designing a good digital experience - PDA Europe Virtual Conference 2020
Majestic MRSS Usability Engineering
College Management System project
UXBASIS – Getting UX integrated
MMRSS Usability Engineering
Things you should know before you build your site
Bridging Current Reality & Future Vision with Reality Maps
Heuristics Evaluation - How to Guide.pdf
Heuristics Evaluation - How to Guide.pdf
Basics of-usability-testing
Integrating User Centered Design with Agile Development
Web Engineering
User Experience & Design…Designing for others…UED
online news portal system
Design process
How technical writers can contribute to the user experience

More from Scott Abel (20)

PPTX
2023 Challenges and Opportunities Impacting Technical Documentation Team Capa...
PDF
The Cognitive Era and the Future of Content
PDF
The cognitive era and the future of content
PDF
Establishing thought leadership with content manufacturing and influencer mar...
PDF
Creating A Digital Content Factory: Getting Started with Intelligent Content
PDF
Intelligent Content in the Experience Age by Scott Abel, The Content Wrangler
PDF
Emerging Trends in Visual Content Marketing with Adam Helweh
PDF
Scalable Content Strategy: Nice Thought or Viable Vision? with Colleen Jones
PDF
Content Strategy Across Geographies and Platforms with Melinda Flores
PDF
The ROI of Intelligent Content with Mark Lewis, DITA Educator, Quark
PDF
Content Strategy for Technical Communication and Beyond with Gretyl Kinsey, S...
PDF
The Future of Technical Communication is Marketing with Scott Abel, The Conte...
PDF
Clear and Simple: Lower Your Content Costs with Global English with Matthew K...
PDF
Fandom Isn't Random with Andrew Thomas, SDL
PDF
Deep Dive: Structured XML Authoring with George Bina, oXygen XML Editor
PDF
The Future of Technical Communication is Marketing
PDF
The Making of 'The Language of Content Strategy' - by Scott Abel, The Content...
PDF
5 Revolutionary Technologies Technical Communicators Can’t Afford To Ignore
PDF
Content Marketing Futurist: Revolutionary Technologies Content Marketers Can’...
PDF
Thinking Strategically About Content - Localization World Singapore
2023 Challenges and Opportunities Impacting Technical Documentation Team Capa...
The Cognitive Era and the Future of Content
The cognitive era and the future of content
Establishing thought leadership with content manufacturing and influencer mar...
Creating A Digital Content Factory: Getting Started with Intelligent Content
Intelligent Content in the Experience Age by Scott Abel, The Content Wrangler
Emerging Trends in Visual Content Marketing with Adam Helweh
Scalable Content Strategy: Nice Thought or Viable Vision? with Colleen Jones
Content Strategy Across Geographies and Platforms with Melinda Flores
The ROI of Intelligent Content with Mark Lewis, DITA Educator, Quark
Content Strategy for Technical Communication and Beyond with Gretyl Kinsey, S...
The Future of Technical Communication is Marketing with Scott Abel, The Conte...
Clear and Simple: Lower Your Content Costs with Global English with Matthew K...
Fandom Isn't Random with Andrew Thomas, SDL
Deep Dive: Structured XML Authoring with George Bina, oXygen XML Editor
The Future of Technical Communication is Marketing
The Making of 'The Language of Content Strategy' - by Scott Abel, The Content...
5 Revolutionary Technologies Technical Communicators Can’t Afford To Ignore
Content Marketing Futurist: Revolutionary Technologies Content Marketers Can’...
Thinking Strategically About Content - Localization World Singapore

Recently uploaded (20)

PPTX
The Marketing Journey - Tracey Phillips - Marketing Matters 7-2025.pptx
PDF
SIMNET Inc – 2023’s Most Trusted IT Services & Solution Provider
DOCX
Euro SEO Services 1st 3 General Updates.docx
PDF
A Brief Introduction About Julia Allison
PDF
Roadmap Map-digital Banking feature MB,IB,AB
PDF
Reconciliation AND MEMORANDUM RECONCILATION
PDF
Dr. Enrique Segura Ense Group - A Self-Made Entrepreneur And Executive
PDF
Ôn tập tiếng anh trong kinh doanh nâng cao
PPTX
ICG2025_ICG 6th steering committee 30-8-24.pptx
PDF
Training And Development of Employee .pdf
DOCX
Business Management - unit 1 and 2
PDF
Laughter Yoga Basic Learning Workshop Manual
PPTX
Lecture (1)-Introduction.pptx business communication
PDF
20250805_A. Stotz All Weather Strategy - Performance review July 2025.pdf
PDF
Unit 1 Cost Accounting - Cost sheet
PDF
kom-180-proposal-for-a-directive-amending-directive-2014-45-eu-and-directive-...
PDF
COST SHEET- Tender and Quotation unit 2.pdf
PDF
How to Get Funding for Your Trucking Business
PDF
IFRS Notes in your pocket for study all the time
PDF
BsN 7th Sem Course GridNNNNNNNN CCN.pdf
The Marketing Journey - Tracey Phillips - Marketing Matters 7-2025.pptx
SIMNET Inc – 2023’s Most Trusted IT Services & Solution Provider
Euro SEO Services 1st 3 General Updates.docx
A Brief Introduction About Julia Allison
Roadmap Map-digital Banking feature MB,IB,AB
Reconciliation AND MEMORANDUM RECONCILATION
Dr. Enrique Segura Ense Group - A Self-Made Entrepreneur And Executive
Ôn tập tiếng anh trong kinh doanh nâng cao
ICG2025_ICG 6th steering committee 30-8-24.pptx
Training And Development of Employee .pdf
Business Management - unit 1 and 2
Laughter Yoga Basic Learning Workshop Manual
Lecture (1)-Introduction.pptx business communication
20250805_A. Stotz All Weather Strategy - Performance review July 2025.pdf
Unit 1 Cost Accounting - Cost sheet
kom-180-proposal-for-a-directive-amending-directive-2014-45-eu-and-directive-...
COST SHEET- Tender and Quotation unit 2.pdf
How to Get Funding for Your Trucking Business
IFRS Notes in your pocket for study all the time
BsN 7th Sem Course GridNNNNNNNN CCN.pdf

Optimizing The User Experience Through Integrated Information Design

  • 1. Optimizing the User Experience Through Integrated Information Design Sowmini Sampath and Richard Ellis
  • 2. What We’ll Be Talking About In this talk, we’ll describe our approach to developing help solutions that: Integrate context sensitive help (CSH) into product user interfaces Integrate CSH with our existing knowledge base Derive content from interaction analysis
  • 3. The MathWorks Products The MathWorks produces software for engineers and researchers in a variety of industries: Automotive Electronics Industrial equipment Telecommunications
  • 4. How People Use Our Products? Users create computer models Run simulations Perform data analysis and visualization Create new tools and applications using our software.
  • 5.  
  • 6.  
  • 7. Task Complexity User tasks often require configuring a number of complex dialogs. Each element represents a decision that the user must make.
  • 8. Designing Help for Graphical User Interfaces (GUIs) Increasing use of GUIs by products required better help design Design goals: Integrate user assistance into product interfaces. Provide targeted information for each decision Make CSH an entry point into the existing user documentation.
  • 9. Initial Investigations Needed to partner with engineers to integrate the help into the interface. Many people thought context sensitive help was of little value. Why had people rarely found it useful?
  • 10. What Was Not Working Tooltips were often used to provide scant information Help button dove into usage topics and often required you to wade through a pool information to find the answer.
  • 11. Why it Was Not Working Tooltips lack: Enough information Linking Formatting Not persistent Help browser: Overwhelming amount of information Deep hierarchy of information Is cumbersome – starting another application Need to provide the right amount and type of information.
  • 12. Analysis of User Help Requirements We developed use cases, observed usability test, and brainstormed to develop a model of user information needs. A “critical mass” of information necessary. A progression from specific details to general concepts – information escalation. Avoid quantum leaps in your information escalation path.
  • 13. User Interactions We Support with Help New users tend to explore before doing actual work. Users need to map their task onto the products features Experienced users often wanted to be reminded of details. All users wanted unobtrusive, on-demand information.
  • 14. The On Ramp – Provided by Help Button Purpose High-level workflow Information gateway
  • 15. Field-Level Help Right-click context menu displays a popup window with help on individual item. Purpose Relevant details Link to related information
  • 16. Embedding Help in the User Interface Application starts with instructions displayed Start by doing this Built in on ramp
  • 17. Procedures Update as Work Progresses The help always matches the tool’s current state. Close help pane GUI has reconfigured Help automatically updates
  • 18. Tying It All Together A well planned information escalation path – information must stay in context. We know what users are doing because they have requested help from a particular location in a GUI. Through task analysis the writer has determined what supporting information needs to be in the user’s manual. Our metaphor – the link opens the user’s manual at just the right page.
  • 19. The CSH model integrates all help CSH becomes an entry point into our knowledge base User tasks Product workflow
  • 20. Introduction Brief description of the SimBiology® application Challenges posed to the writing team by the software Implementation of the solution Summary
  • 21. SimBiology® SimBiology is a product from the MathWorks that lets biologists visualize and analyze biochemical reactions. The SimBiology application extends MATLAB® for use by scientists in academia, and in the biotech and pharmaceutical industry.
  • 23. How to Begin? We started by analyzing the user’s workflow: Took a user’s task and mapped it out in the SimBiology GUI Created task scenarios and did usability testing Noted user interactions with the GUI to help drive the design process Observed that there were many sub tasks within the overall workflow
  • 24. Selecting a Solution Selected embedded procedures as the solution to documenting subtasks
  • 25.  
  • 26.  
  • 27. Observation Novice user asks “Where do I begin? Having these multiple tasks confront the user posed a different challenge: Users may not know what they need before and what they must do after in the overall workflow.
  • 28. Solution Provide an on-ramp to the GUI Provide an overall view of the general workflow, and show how to map tasks to product features
  • 29.  
  • 32. Process of Creating the Diagram Helped us conceptualize the workflow Learned about user task scenarios Help us understand what information the target audience needs
  • 33. Observation Experienced users require more in-depth information but want this in the context of their task.
  • 34. Solution A path to more in depth information that is closely related to users’ tasks – information must stay in context or users do not read it.
  • 35.  
  • 36. Summary of SimBiology Help SimBiology documentation includes: Embedded-help pane Procedures to accomplish typical tasks in the GUI Cross-references to supporting information Usage Topics An overall view of the general workflow, and how to map tasks to product features In-depth information – conceptual topics, tutorials, reference materials with lots of examples
  • 37. CSH becomes an entry point into our information system Conceptual topics Tutorials Reference

Editor's Notes

  • #2: Hello, I’m Richard Ellis. My colleague Sowmini Sampath and I are members of the technical writing staff at a local software company called The MathWorks.