DocWizards: a system for authoring follow-me documentation wizards

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.

REFERENCES

• 1: Tessa Lau , Lawrence Bergman , Vittorio Castelli , Daniel Oblinger, Sheepdog: learning procedures for technical support, Proceedings of the 9th international conference on Intelligent user interface, January 13-16, 2004, Funchal, Madeira, Portugal [doi>10.1145/964442.964464]
• 2: http://www.eclipse.org
• 3: Castelli, V, Bergman, L, Lau, T., and Oblinger, D., Layering advanced UI functionalities on existing applications, IBM Technical Report RC23583, 2005.
• 4: Daniel Oblinger, D., Castelli, V., Bergman, L. and Lau, T. Similarity-Based Alignment and Generalization. To appear in Proceedings of ECML 2005.
• 5: http://sourceforge.net/projects/abbot/
• 6: http://www.macromedia.com/software/robohelp/
• 7: http://www.rwd.com/products_services/enterprise_learning_solutions/products/infopak_simulator/
• 8: Allen Cypher , Daniel C. Halbert , David Kurlander , Henry Lieberman , David Maulsby , Brad A. Myers , Alan Turransky, Watch what I do: programming by demonstration, MIT Press, Cambridge, MA, 1993
• 9: Henry Lieberman, ed. Your Wish is My Command: Programming by Example. (2001). Morgan Kaufmann.
• 10: Safonov, A., Konstan, J.A., and Carlis, J.V., Beyond Hard-to-Reach Pages: Interactive, Parametric Web Macros, In Proceedings of HFWeb 2001.
• 11: Henry Lieberman, Tinker: a programming by demonstration system for beginning programmers, Watch what I do: programming by demonstration, MIT Press, Cambridge, MA, 1993
• 12: J. M. Carroll , D. S. Kay, Prompting, feedback and error correction in the design of a scenario machine, International Journal of Man-Machine Studies, v.28 n.1, p.11-27, January 1988 [doi>10.1016/S0020-7373(88)80050-6]
• 13: Susan Palmiter , Jay Elkerton, An evaluation of animated demonstrations of learning computer-based tasks, Proceedings of the SIGCHI conference on Human factors in computing systems: Reaching through technology, p.257-263, April 27-May 02, 1991, New Orleans, Louisiana, United States [doi>10.1145/108844.108906]
• 14: 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.
• 15: 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.
• 16: 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.
• 17: Ted Selker, COACH: a teaching agent that learns, Communications of the ACM, v.37 n.7, p.92-99, July 1994 [doi>10.1145/176789.176799]

INDEX TERMS

Primary Classification:
  H. Information Systems
  H.5 INFORMATION INTERFACES AND PRESENTATION (I.7)
      H.5.2 User Interfaces (D.2.2, H.1.2, I.3.6)
          Subjects: Training, help, and documentation

General Terms:
Algorithms, Documentation, Human Factors

Keywords:
documentation generation, programming-by-demonstration