Lawrence Bergman
ABSTRACT
Traditional documentation for computer-based procedures is difficult to use: readers have trouble navigating long complex instructions, have trouble mapping from the text to display widgets, and waste time performing repetitive procedures. We propose a new class of improved documentation that we call follow-me documentation wizards. Follow-me documentation wizards step a user through a script representation of a procedure by highlighting portions of the text, as well application UI elements. This paper presents algorithms for automatically capturing follow-me documentation wizards by demonstration, through observing experts performing the procedure. We also present our DocWizards implementation on the Eclipse platform. We evaluate our system with an initial user study that showing that most users have a marked preference for this form of guidance over traditional documentation.
- Tessa Lau, Lawrence Bergman, Vittorio Castelli, Daniel Oblinger, Sheepdog: Learning Procedures for Technical Support. In Proceedings of IUI 2004, Madeira, Portugal, January 2004, pp. 109--116, Google Scholar
Digital Library
- http://www.eclipse.orgGoogle Scholar
- Castelli, V, Bergman, L, Lau, T., and Oblinger, D., Layering advanced UI functionalities on existing applications, IBM Technical Report RC23583, 2005.Google Scholar
- Daniel Oblinger, D., Castelli, V., Bergman, L. and Lau, T. Similarity-Based Alignment and Generalization. To appear in Proceedings of ECML 2005. Google ScholarDigital Library
- http://sourceforge.net/projects/abbot/Google Scholar
- http://www.macromedia.com/software/robohelp/Google Scholar
- http://www.rwd.com/products_services/enterprise_learning_solutions/products/infopak_simulator/Google Scholar
- Allen Cypher, ed. Watch What I Do: Programming by Demonstration. (1993). MIT Press, Cambridge, MA. Google ScholarDigital Library
- Henry Lieberman, ed. Your Wish is My Command: Programming by Example. (2001). Morgan Kaufmann.Google Scholar
- Safonov, A., Konstan, J.A., and Carlis, J.V., Beyond Hard-to-Reach Pages: Interactive, Parametric Web Macros, In Proceedings of HFWeb 2001.Google Scholar
- Henry Lieberman, Tinker: A programming by Demonstration System for Beginning Programmers., In Watch What I Do: Programming by Demonstration. (1993). MIT Press, Cambridge, MA. Google ScholarDigital Library
- Carroll, J.M. and Kay, D.S. (1988). Prompting, feedback and error correction in the design of the scenario machine. International Journal of Man-Machine Studies, 28:11--27. Google ScholarDigital Library
- Palmiter, S. & Elkerton, J. (1991). An evaluation of animated demonstrations for learning computer-based tasks, In S.P. Robertson, G.M. Olson, & J.S. Olson (Eds.), Human Factors in Computing Systems: CHI'91 Conference Proceedings. NY: ACM, pp. 257--263. Google ScholarDigital Library
- Anderson, J. R., Boyle, C. F., Farrell, R., & Reiser, B. J. (1987). Cognitive principles in the design of computer tutors. In P. Morris (Ed.), Modeling Cognition, Wiley.Google Scholar
- Anderson, J.R., & Pelletier, R. (1991). A development system for model-tracing tutors. In Proceedings of the International Conference of the Learning Sciences, 1--8.Google Scholar
- Farrell, R. and Lefkowitz, L. Supporting Development of On-line Task Guidance for Software System Users. In Facilitating the Development and Use of Interactive Learning Environments, C. P. Bloom & R.B. Loftin, (Eds.), 1998.Google Scholar
- Ted Selker, Coach: A Teaching Agent that Learns. In Communications of the ACM, July, 1994. Vol. 37, No. 7, pp. 92--99. Google ScholarDigital Library
Index Terms
- DocWizards: a system for authoring follow-me documentation wizards
Recommendations
Haddock, a Haskell documentation tool
Haskell '02: Proceedings of the 2002 ACM SIGPLAN workshop on HaskellThis paper describes Haddock, a tool for automatically generating documentation from Haskell source code. Haddock's unique approach to source code annotations provides a useful separation between the implementation of a library and the interface (and ...
WWW based structuring of codesigns
ISSS '95: Proceedings of the 8th international symposium on System synthesisAbstract: This paper describes a codesign environment based on the WWW (World Wide Web) and its implementation. Tool invocations and their respective results are linked using hypertext documents. We show how to configure a WWW browser for spawning ...
Building Documentation Generators
ICSM '99: Proceedings of the IEEE International Conference on Software MaintenanceIn order to maintain the consistency between sources and documentation, while at the same time providing documentation at the design level, it is necessary to generate documentation from sources in such a way that it can be integrated with hand-written ...
Comments