skip to main content
10.1145/584955.584957acmconferencesArticle/Chapter ViewAbstractPublication PagesdocConference Proceedingsconference-collections
Article

Showing instead of telling

Published:20 October 2002Publication 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. Google ScholarGoogle ScholarDigital LibraryDigital 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.htmlGoogle ScholarGoogle Scholar
  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.Google ScholarGoogle Scholar
  4. Baecker, R. (2002a). Highly Interactive Webcasting with Structured Archives. Poster presentation at ACM CSCW'2002, New Orleans, LA., 16--20 Nov. 2002.Google ScholarGoogle Scholar
  5. Baecker, R. (2002b). Design Principles and System Architecture for Rich Media Interactive Webcasting with Structured Archives, submitted for review.Google ScholarGoogle Scholar
  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. Google ScholarGoogle ScholarDigital LibraryDigital 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.) Google ScholarGoogle ScholarDigital LibraryDigital 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.Google ScholarGoogle Scholar
  9. Baecker, R., Small, I. S., and Mander, R. (1991). Bringing Icons to Life, Proc. CHI '91, 1--6. Google ScholarGoogle ScholarDigital LibraryDigital Library
  10. Baecker, R.M. and Smith, E. (2002). Hierarchical Structure in the Digital Video Lifecycle. Draft manuscript.Google ScholarGoogle Scholar
  11. Bayles, M. (2002). Designing Online Banner Advertisements: Should we Animate?, Proc. CHI'2002, 363--366. Google ScholarGoogle ScholarDigital LibraryDigital 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. Google ScholarGoogle ScholarDigital LibraryDigital Library
  13. Buxton, W. (1989). Introduction to this Special Issue on Non-Speech Audio. Human-Computer Interaction 4(1).Google ScholarGoogle Scholar
  14. Carroll, J.M. (1990). The Nurnberg Funnel: Designing Minimalist Instruction for Practical Computer Skill. MIT Press. Google ScholarGoogle ScholarDigital LibraryDigital Library
  15. DiGiano, C. and Baecker, R. (1992). Program Auralization: Sound Enhancements to the Programming Environment, Proc. Graphics Interface '92, 44--52. Google ScholarGoogle ScholarDigital LibraryDigital Library
  16. Finn, K., Sellen, A., and Wilbur, S. (Eds.) (1977), Video-Mediated Communication. Erlbaum. Google ScholarGoogle ScholarDigital LibraryDigital 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. Google ScholarGoogle ScholarDigital LibraryDigital Library
  18. Hsi, I., and Potts, C. (2000). Studying the Evolution and Enhancement of Software Features. Proc. International Conference on Software Maintenance, 143--151. Google ScholarGoogle ScholarDigital LibraryDigital Library
  19. Horton, W. (1994). The Icon Book: Visual Symbols for Computer Systems and Documentation, Wiley. Google ScholarGoogle ScholarDigital LibraryDigital Library
  20. Jackson. S. (2001). Editing Computer Hardware Procedures for Multimedia Presentation, Proc. 19th Annual Conf. on Systems Documentation, 68--72. Google ScholarGoogle ScholarDigital LibraryDigital 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.Google ScholarGoogle ScholarCross RefCross Ref
  22. McGrenere, J. and Moore, G. (2000). Are We All In the Same "Bloat"?, Proc. Graphics Interface 2000, 187--196.Google ScholarGoogle Scholar
  23. Paivio, A. (1990). Mental Representation: A Dual Coding Approach, Oxford University Press.Google ScholarGoogle Scholar
  24. Price, J. (2001). A Rhetoric of Objects, Proc. 19th Annual Conf. on Systems Documentation, 147--151. Google ScholarGoogle ScholarDigital LibraryDigital 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.Google ScholarGoogle ScholarCross RefCross Ref
  26. Priestley, M. (2001). DITA XML: A Reuse by Reference Architecture for Technical Documentation, Proc. 19th Annual Conf. on Systems Documentation, 152--156. Google ScholarGoogle ScholarDigital LibraryDigital 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. Google ScholarGoogle ScholarDigital LibraryDigital 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. Google ScholarGoogle ScholarDigital LibraryDigital 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. Google ScholarGoogle ScholarDigital LibraryDigital 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. Google ScholarGoogle ScholarDigital LibraryDigital Library
  31. Stasko, J., Domingue, J., Brown, M., and Price, B. (Eds.) (1998). Software Visualization: Programming as a Multimedia Experience. MIT Press. Google ScholarGoogle ScholarDigital LibraryDigital Library
  32. Wetzel, C., Radtke, P., & Stern, H. (1994). Instructional Effectiveness of Video Media, Erlbaum.Google ScholarGoogle Scholar

Index Terms

  1. Showing instead of telling

    Recommendations

    Comments

    Login options

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

    Sign in
    • 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

      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]

      Publisher

      Association for Computing Machinery

      New York, NY, United States

      Publication History

      • Published: 20 October 2002

      Permissions

      Request permissions about this article.

      Request Permissions

      Check for updates

      Qualifiers

      • Article

      Acceptance Rates

      Overall Acceptance Rate355of582submissions,61%

    PDF Format

    View or Download as a PDF file.

    PDF

    eReader

    View online with eReader.

    eReader