CHAPTER 14: Documentation and User Support (a.k.a Help)

Slides:



Advertisements
Similar presentations
Support.ebsco.com EBSCOhost Digital Archives Viewer Tutorial.
Advertisements

1 Software User Documentation Don Bagert CSSE 375, Rose-Hulman October 9, 2006.
Chapter 2 Web Site Design Principles Principles of Web Design, Third Edition.
Software Construction and Evolution - CSSE 375 Software Documentation 1 Shawn & Steve Right – For programmers, it’s a cultural perspective. He’d feel almost.
Chapter 15 Designing Effective Output
WYNN Reader/Wizard Training Module Karie Lawrence Cypress-Fairbanks I.S.D.
Document and Web design has five goals:
Web-designWeb-design. Web design What is it? Web-design features Before…
1 On-Line Help and User Documentation  User manuals, online help, and tutorials are typically not used  However, well written and well-designed user.
1 On-Line Help and User Documentation  User manuals, online help, and tutorials are typically not used  However, well written and well-designed user.
Chapter 7. Designing Documents and Web Sites © 2013 by Bedford/St. Martin's1 Document and Web design has five goals: to make a good impression on readers.
Chapter 2 Web Site Design Principles Principles of Web Design, Third Edition.
Chapter 2 Web Site Design Principles Principles of Web Design, 4 th Edition.
1 On-Line Help and User Documentation  User manuals, online help, and tutorials are typically not used  However, well written and well-designed user.
Microsoft Expression Web 3 Expression Web Design Feature Web Design Basics.
Easy WP Guide V2.6 for WordPress 3.8. easywpguide.com Adding Tags within your Post Adding Tags whilst editing your Post, will automatically assign those.
Computer/LMS Access To log onto one of these computers: Enter your Username, for example: 2014BNS099 followed So a complete login.
Made with OpenOffice.org 1 Beyond the Single Page Steve Oualline OpenOffice Writer.
Chapter 8 Using Document Collaboration, Integration, and Charting Tools Microsoft Word 2013.
General System Navigation
Literary Reference Center
Thinking Web > CONTENT DEVELOPMENT
Human Computer Interaction Lecture 21 User Support
Jeopardy Word-1 Word-2 Word-3 Word-4 Word-5 Q $100 Q $100 Q $100
4.2 Microsoft Word.
Microsoft PowerPoint This is the introduction to PowerPoint.
Objectives Overview Identify the four categories of application software Describe characteristics of a user interface Identify the key features of widely.
Human Computer Interaction Lecture 21,22 User Support
Making the Web Accessible to Impaired Users
Literary Reference Center
Literary Reference Center
Designing the User Interface: Strategies for Effective Human-Computer Interaction 6th Edition Ben Shneiderman, Catherine Plaisant, Maxine Cohen, Steven.
Link Label Text Label… Click Here… Image Image Lorem Ipsum Lorem Ipsum
You will be given the answer. You must give the correct question.
Software Documentation
CHAPTER 8 Multimedia Authoring Tools
Lesson 9 Sharing Documents
Word and the Writing Process
Microsoft PowerPoint This is the introduction to PowerPoint.
Microsoft Word 2003 Illustrated Complete
Lesson 9 Sharing Documents
Office 2010 and Windows 7: Essential Concepts and Skills
Lippincott Procedures Training Tour for HealthStream Users
Objective % Explain concepts used to create websites.
Getting Started with Microsoft Office 2010
Duke University Health System
4.2 Microsoft Word.
Word Tutorial 3 Creating Tables and a Multipage Report
How Students Navigate a Test and Use Test Tools
CHAPTER 12: User Documentation and Online Help
How many times have you been faced with a pressing school nutrition question and couldn’t quickly locate the answer? We have just the tool to make that.
Chapter 2 – Introduction to the Visual Studio .NET IDE
Literary reference center
Microsoft PowerPoint This is the introduction to PowerPoint.
Start the Tour „ ABOUT THE GUIDED TOUR Next „
Literary Reference Center
Lippincott Procedures Training Tour for General Users
HCI and Hypermedia/WWW
Lesson 14 Sharing Documents
Lippincott’s Nursing Procedures and Skills
CHAPTER 12: User Documentation and Online Help
Fundamentals of Using Microsoft Windows XP
EBSCOhost Digital Archives Viewer
Chapter 2 Web Site Design Principles
PowerPoint Lesson 1 Microsoft Word Basics
CIS 375 Bruce R. Maxim UM-Dearborn
Training Tour for General Users
Chapter 8 Using Document Collaboration and Integration Tools
Microsoft PowerPoint This is the introduction to PowerPoint.
Welcome To Microsoft Word 2016
Presentation transcript:

CHAPTER 14: Documentation and User Support (a.k.a Help) Designing the User Interface: Strategies for Effective Human-Computer Interaction Sixth Edition Ben Shneiderman, Catherine Plaisant, Maxine S. Cohen, Steven M. Jacobs, and Niklas Elmqvist in collaboration with Nicholas Diakopoulos

Documentation and User Support (a.k.a Help) Topics Introduction Shaping the Content of the Documentation Accessing the Documentation Reading from Displays versus Reading from Paper Online Tutorials and Animated Demonstrations Online Communities and Avenues for User Support The Development Process

Introduction When it comes to learning about computer systems many people experience anxiety, frustration, and disappointment Even though increasing attention is being paid to improving interface design, complex systems can still benefit context-sensitive, online help User’s Goal Help I want to buy it Animated demonstration I want to learn it  Manual, tutorial, guide, animated demonstration I want to use it  Manual, help, context-sensitive help I want to solve a problem  Help, FAQ, online community

Shaping the Content of the Documentation Fig. 14.1 This particular quick start guide is for Microsoft OneNote 2016 it points out common actions for users Its goal is to minimize the learning curve for users upgrading from a previous version The quick start guide is four pages, this is the first page Explanations are provided for the toolbar and the ribbon in addition to other commonly used features

Organization and Writing Style Fig. 14.2 The documentation content is organized as single source topics created, during the authoring process, with the intention of reuse The various documentation end-products (compiled help, website, print) are mapped from the various combinations of the single source topics

Reading from paper versus from displays Fig. 14.3 The heat maps from the eye tracking study Red indicates the area where the user looked most, yellow indicates fewer views, and blue indicates the fewest views Gray is used for areas that were not viewed The image on the left is from an article in the “About us” section of a corporate web site, the center image is a product page on an e-commerce web site, and the image on the right is from a search engine results page (Jakob Nielsen)

Writing for the Web Break your text into short sections with clear headings Start with your key message Write short sentences and short paragraphs Use lists and tables – tables may not work well for mobile devices Write meaningful links (do not use: “click here”) Illustrate your content

Advantages of Online Documentation Physical advantages available whenever on web-connected electronic device, can’t get lost or misplaced, physical workspace not needed, can be updated rapidly Navigation features can provide index and other search facilities, can link to other external materials and sources Interactive services can bookmark, annotate, and tag, can include graphics, sound, color, and animation, screen readers or other tools can be provided for users with disabilities

Online Help Fig. 14.4 This figure provides a step by step approach to the activities in a database migration application The details involved in each step can be found on the left hand side The actual action and activity is in the middle On the bottom is a road map for the steps involved the steps are marked as to their status (completed, in progress, not started) For novices it would be easy to insert links to more detailed tutorial-type information www.fmpromigrator.com

Online Help (continued) Fig. 14.5 This shows a small tool-tip or fly-over help on Microsoft Word Moving the mouse (cursor) over a particular icon causes an explanation of the icon to appear on the screen

Online Help (concluded) Fig. 14.6 Since this is a complicated music interface, interactive help is provided for many of the fields This figure shows all the help balloons open Several standard icons are used such as new, import, record, play, but other specific icons explain the various modes that are available using the tool http://www.saxopedia.com/2013/12/07/calypso-score-the-perfect-ipad-music-score-reader/

Reading from paper versus from displays Visual fatigue and stress from reading computer displays are common problems, but these conditions respond well to rest, frequent breaks, and task diversity Even if users are not aware of visual fatigue or stress, their capacity to work with displays may be below their capacity to work with paper documentation Fig. 14.7

Reading from paper versus from displays (concluded) Designers should be aware how poor information design can make reading more difficult and disrupt the process Some guidelines for supporting reading are: Don’t use uncommon or unfamiliar vocabulary Avoid difficult to read typefaces (all caps is harder to read) Avoid text on busy backgrounds Avoid information buried in repetition Do not use centered text Fig. 14.10 and 14.11 New eBook devices will be created that support the metaphor from physical books, allowing the user to flip the pages to scan the contents of the book.

Online manuals and help (example) The National Institute for Health’s site for seniors (http://www.nihseniorhealth.gov) has controls to adjust the text size, adjust the contrast, and turn speech on or off. The font used is a sans-serif font, and the font size is larger than the typical size used on the Web. Several ways are provided to navigate through the information (alphabetical, grouping by category, etc.). Fig. 14.9

How highlighting, fonts etc. help the user Fig. 14.12 This is a specialized interface called Tagged Comments The comments section can be found in the lower right corner Comments can be read and briefly scanned by looking at the included icons (smiley faces) In the upper right corner, the user can filter the comments by category The tutorial content is seen on the left Another window that does not show in this figure would allow a user to submit a comment

Development process guidelines Seek professional content writers and copywriters Prepare user documentation early (before implementation) May act as an alternative to the formal s/w specification. Set up guideline documents and coordinate and integrate across all involved departments Review drafts thoroughly Field-test early editions Provide feedback mechanisms for readers Revise to reflect changes regularly