More Web Proxy on the site http://driver.im/

Article

Showing instead of telling

Author:

Ron BaeckerAuthors Info & Claims

SIGDOC '02: Proceedings of the 20th annual international conference on Computer documentation

Pages 10 - 16

https://doi.org/10.1145/584955.584957

Published: 20 October 2002 Publication History

Abstract

We propose the use of dynamic visual representations to augment traditional static text as documentation. In other words, we suggest using live demonstrations or moving pictures to show people how to do things, and not just using written or spoken words to tell them what to do. We present and illustrate examples of five methods and technologies for creating such dynamic documentation, and summarize what is known about their effectiveness.

References

[1]

Ames, A. (2001). Just What They Need, Just When They Need It: An Introduction to Embedded Assistance, Proc. 19th Annual Conf. on Systems Documentation, 111--115.

Digital Library

[2]

Baecker, R. (1982). Sorting Out Sorting, 30 minute colour sound film, available to order on video from http://www.utoronto.ca/~ic/media/vidcol/science.html

[3]

Baecker, R. (1998). Sorting Out Sorting: A Case Study of Software Visualization for Teaching Computer Science. In Stasko, J., Domingue, J., Brown, M., and Price, B. (Eds.), Software Visualization: Programming as a Multimedia Experience. MIT Press, 369--381.

[4]

Baecker, R. (2002a). Highly Interactive Webcasting with Structured Archives. Poster presentation at ACM CSCW'2002, New Orleans, LA., 16--20 Nov. 2002.

[5]

Baecker, R. (2002b). Design Principles and System Architecture for Rich Media Interactive Webcasting with Structured Archives, submitted for review.

[6]

Baecker, R., Booth, K., Jovicic, S., McGrenere, J., and Moore, G. (2000). Bridging the Gap Between What Users Know and What They Need to Know, Proc. ACM CUU2000 Conference on Universal Usability, 17--23.

Digital Library

[7]

Baecker, R., Rosenthal, A., Friedlander, N., Smith, E., and Cohen, A. (1996). A Multimedia System for Authoring Motion Pictures, Proc. ACM Multimedia'96, 31--42. (Reprinted in Jaffay, K. and Zhang, H.J. Readings in Multimedia Computing and Networking, Morgan Kaufmann, 2002, 836--847.)

Digital Library

[8]

Baecker, R. and Small, I. (1990). Animation at the Interface In The Art of Human-Computer Interface Design (B. Laurel, Editor), Addison-Wesley, 251--267.

[9]

Baecker, R., Small, I. S., and Mander, R. (1991). Bringing Icons to Life, Proc. CHI '91, 1--6.

Digital Library

[10]

Baecker, R.M. and Smith, E. (2002). Hierarchical Structure in the Digital Video Lifecycle. Draft manuscript.

[11]

Bayles, M. (2002). Designing Online Banner Advertisements: Should we Animate?, Proc. CHI'2002, 363--366.

Digital Library

[12]

Berglund, E, and Priestley, M. (2001). Open-Source Documentation: In Search of User-driven, Just-in-time Writing, Proc. 19th Annual Conf. on Systems Documentation, 132--141.

Digital Library

[13]

Buxton, W. (1989). Introduction to this Special Issue on Non-Speech Audio. Human-Computer Interaction 4(1).

[14]

Carroll, J.M. (1990). The Nurnberg Funnel: Designing Minimalist Instruction for Practical Computer Skill. MIT Press.

Digital Library

[15]

DiGiano, C. and Baecker, R. (1992). Program Auralization: Sound Enhancements to the Programming Environment, Proc. Graphics Interface '92, 44--52.

Digital Library

[16]

Finn, K., Sellen, A., and Wilbur, S. (Eds.) (1977), Video-Mediated Communication. Erlbaum.

Digital Library

[17]

He, S. (2001). Interplay of Language and Culture in Global E-commerce: A Comparison of Five Companies' Multilingual Websites, Proc. 19th Annual Conf. on Systems Documentation, 83--88.

Digital Library

[18]

Hsi, I., and Potts, C. (2000). Studying the Evolution and Enhancement of Software Features. Proc. International Conference on Software Maintenance, 143--151.

Digital Library

[19]

Horton, W. (1994). The Icon Book: Visual Symbols for Computer Systems and Documentation, Wiley.

Digital Library

[20]

Jackson. S. (2001). Editing Computer Hardware Procedures for Multimedia Presentation, Proc. 19th Annual Conf. on Systems Documentation, 68--72.

Digital Library

[21]

Mayer, E. and Sims, V. (1994). For Whom Is a Picture Worth a Thousand Words? Extensions of a Dual-coding Theory of Multimedia Learning, Journal of Educational Psychology 86(3), 389--410.

[22]

McGrenere, J. and Moore, G. (2000). Are We All In the Same "Bloat"?, Proc. Graphics Interface 2000, 187--196.

[23]

Paivio, A. (1990). Mental Representation: A Dual Coding Approach, Oxford University Press.

[24]

Price, J. (2001). A Rhetoric of Objects, Proc. 19th Annual Conf. on Systems Documentation, 147--151.

Digital Library

[25]

Price, B., Baecker, R., and Small, I. (1993). A Principled Taxonomy of Software Visualization, Journal of Visual Languages and Computing, 4(3), Sept. 1993, 211--266.

[26]

Priestley, M. (2001). DITA XML: A Reuse by Reference Architecture for Technical Documentation, Proc. 19th Annual Conf. on Systems Documentation, 152--156.

Digital Library

[27]

Russell, J. (2001). "Yes, But Does It Scale?" - Practical Considerations for Database-driven Information Systems, Proc. 19th Annual Conf. on Systems Documentation, 12--21.

Digital Library

[28]

Silveira, M., Siechenius de Souza, C., and Barbosa, D. (2001). Semiotic Engineering Contributions for Designing Online Help Systems, Proc. 19th Annual Conf. on Systems Documentation, 31--38.

Digital Library

[29]

Spinuzzi, C. (2001). Software Development as Mediated Activity: Applying Three Analytical Frameworks for Studying Compound Mediation, Proc. 19th Annual Conf. on Systems Documentation, 58--67.

Digital Library

[30]

Stasko, J., Badre, A., and Lewis, C. (1993). Do Algorithm Animations Assist Learning? An Empirical Study and Analysis, Proc. INTERCHI'93, 61--66.

Digital Library

[31]

Stasko, J., Domingue, J., Brown, M., and Price, B. (Eds.) (1998). Software Visualization: Programming as a Multimedia Experience. MIT Press.

Digital Library

[32]

Wetzel, C., Radtke, P., & Stern, H. (1994). Instructional Effectiveness of Video Media, Erlbaum.

Cited By

Chundury PYalçin MCrabtree JMahurkar AShulman LElmqvist N(2022)Contextual in situ help for visual data interfacesInformation Visualization10.1177/1473871622112006422:1(69-84)Online publication date: 9-Sep-2022
https://doi.org/10.1177/14738716221120064
Shachak ARandhawa GCrampton N(2019)Educational approaches for improving physicians’ use of health information technologyHealthcare Management Forum10.1177/084047041983171732:4(188-191)Online publication date: 28-Mar-2019
https://doi.org/10.1177/0840470419831717
Randhawa GShachak ACourtney KKushniruk A(2019)Evaluating a post-implementation electronic medical record training intervention for diabetes management in primary careBMJ Health & Care Informatics10.1136/bmjhci-2019-10008626:1(e100086)Online publication date: 30-Sep-2019
https://doi.org/10.1136/bmjhci-2019-100086
Show More Cited By

Index Terms

Showing instead of telling
1. Human-centered computing
  1. Human computer interaction (HCI)

Recommendations

Perception of gender-stereotype in films: a case study on "Captain Marvel" superhero movie
ICMIP '20: Proceedings of the 5th International Conference on Multimedia and Image Processing

This paper aims to examine the perception of Malaysians on the issues related to gender-stereotypes in superhero genre movies in general, and Captain Marvel movie in specific. The paper aims to call into insight as to whether or not Malaysians accept ...
An art-directed wrinkle system for CG character clothing and skin

We present a kinematic system for creating art-directed clothing and skin wrinkles on CG characters used in the production of computer-animated feature films. This system employs a curve-based method for generating wrinkles on reference poses, which are ...
How to build a fantasy world based on reality: a case study of Final Fantasy XV: part II
SA '17: SIGGRAPH Asia 2017 Courses

From the onset and during the course of development for FINAL FANTASY XV, we built our world around the theme: "a fantasy based on reality". Under this slogan and based on this world, we created the real-time CG game FINAL FANTASY XV, as well as the pre-...

Comments

Please enable JavaScript to view thecomments powered by Disqus.

Information & Contributors

Information

Published In

cover image ACM Conferences

SIGDOC '02: Proceedings of the 20th annual international conference on Computer documentation

October 2002

272 pages

ISBN:1581135432

DOI:10.1145/584955

Conference Chair:
Kathy Haramundanis
Hewlett-Packard Company
,
Program Chair:
Michael Priestley
IBM Toronto

Copyright © 2002 ACM.

Permission to make digital or hard copies of all or part of this work for personal or classroom use is granted without fee provided that copies are not made or distributed for profit or commercial advantage and that copies bear this notice and the full citation on the first page. Copyrights for components of this work owned by others than ACM must be honored. Abstracting with credit is permitted. To copy otherwise, or republish, to post on servers or to redistribute to lists, requires prior specific permission and/or a fee. Request permissions from [email protected]

Sponsors

Publisher

Association for Computing Machinery

New York, NY, United States

Publication History

Published: 20 October 2002

Permissions

Request permissions for this article.

Request Permissions

Check for updates

Author Tags

Qualifiers

Article

Conference

SIGDOC02

Sponsor:

SIGDOC02: 20th International Conference on Systems Documentations

October 20 - 23, 2002

Ontario, Toronto, Canada

Acceptance Rates

Overall Acceptance Rate 355 of 582 submissions, 61%

Contributors

Other Metrics

View Article Metrics

Bibliometrics & Citations

Bibliometrics

Article Metrics

28
Total Citations
View Citations
1,463
Total Downloads

Downloads (Last 12 months)6
Downloads (Last 6 weeks)0

Reflects downloads up to 28 Jan 2025

Other Metrics

View Author Metrics

Citations

Cited By

Chundury PYalçin MCrabtree JMahurkar AShulman LElmqvist N(2022)Contextual in situ help for visual data interfacesInformation Visualization10.1177/1473871622112006422:1(69-84)Online publication date: 9-Sep-2022
https://doi.org/10.1177/14738716221120064
Shachak ARandhawa GCrampton N(2019)Educational approaches for improving physicians’ use of health information technologyHealthcare Management Forum10.1177/084047041983171732:4(188-191)Online publication date: 28-Mar-2019
https://doi.org/10.1177/0840470419831717
Randhawa GShachak ACourtney KKushniruk A(2019)Evaluating a post-implementation electronic medical record training intervention for diabetes management in primary careBMJ Health & Care Informatics10.1136/bmjhci-2019-10008626:1(e100086)Online publication date: 30-Sep-2019
https://doi.org/10.1136/bmjhci-2019-100086
Lafreniere BGrossman TBaudisch PSchmidt AWilson A(2018)Blocks-to-CADProceedings of the 31st Annual ACM Symposium on User Interface Software and Technology10.1145/3242587.3242602(637-648)Online publication date: 11-Oct-2018
https://dl.acm.org/doi/10.1145/3242587.3242602
Korn OBlatz MRees ASchaal JSchwind VGörlich D(2017)Procedural Content Generation for Game Props? A Study on the Effects on User ExperienceComputers in Entertainment 10.1145/297402615:2(1-15)Online publication date: 4-Apr-2017
https://dl.acm.org/doi/10.1145/2974026
Gouvatsos AXiao ZMarsden NZhang J(2017)Posing 3D Models from DrawingsComputers in Entertainment10.1145/272998415:2(1-14)Online publication date: 4-Apr-2017
https://dl.acm.org/doi/10.1145/2729984
Whittinghill DHerring D(2017)A Comparison of Text-Annotated vs. Purely Visio-Spatial Instructions for Video Game Input SequencesComputers in Entertainment10.1145/270052715:2(1-19)Online publication date: 4-Apr-2017
https://dl.acm.org/doi/10.1145/2700527
Öztürk MZengin A(2016)Improved GUI Testing using Task Parallel LibraryACM SIGSOFT Software Engineering Notes10.1145/2894784.293630541:2(1-8)Online publication date: 11-May-2016
https://dl.acm.org/doi/10.1145/2894784.2936305
Torre DLabiche YGenero MElaasar MDas THoisl BKowal M(2016)1st International Workshop on UML Consistency Rules (WUCOR 2015)ACM SIGSOFT Software Engineering Notes10.1145/2894784.289480141:2(34-37)Online publication date: 11-May-2016
https://dl.acm.org/doi/10.1145/2894784.2894801
Avgeriou PErnst NNord RKruchten P(2016)Technical DebtACM SIGSOFT Software Engineering Notes10.1145/2894784.289480041:2(38-41)Online publication date: 11-May-2016
https://dl.acm.org/doi/10.1145/2894784.2894800
Show More Cited By

View Options

Login options

Check if you have access through your login credentials or your institution to get full access on this article.

Full Access

Get this Publication

View options

PDF

View or Download as a PDF file.

eReader

View online with eReader.

Figures

Tables

Media

View Table of Conten