Article

DocWizards: a system for authoring follow-me documentation wizards

Authors:

Lawrence Bergman,

Vittorio Castelli,

Daniel OblingerAuthors Info & Claims

UIST '05: Proceedings of the 18th annual ACM symposium on User interface software and technology

Pages 191 - 200

https://doi.org/10.1145/1095034.1095067

Published: 23 October 2005 Publication History

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. In Proceedings of IUI 2004, Madeira, Portugal, January 2004, pp. 109--116,

Digital Library

[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.

Digital Library

[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, ed. Watch What I Do: Programming by Demonstration. (1993). MIT Press, Cambridge, MA.

Digital Library

[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., In Watch What I Do: Programming by Demonstration. (1993). MIT Press, Cambridge, MA.

Digital Library

[12]

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.

Digital Library

[13]

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.

Digital Library

[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. In Communications of the ACM, July, 1994. Vol. 37, No. 7, pp. 92--99.

Digital Library

Cited By

Wali AMahamad SSulaiman S(2023)Task Automation Intelligent Agents: A ReviewFuture Internet10.3390/fi1506019615:6(196)Online publication date: 29-May-2023
https://doi.org/10.3390/fi15060196
Williams JHarchol-Balter MWang W(2023)The M/M/k with Deterministic Setup TimesACM SIGMETRICS Performance Evaluation Review10.1145/3606376.359357551:1(75-76)Online publication date: 27-Jun-2023
https://dl.acm.org/doi/10.1145/3606376.3593575
Cui SHan KTang JHuang HLi XLi Z(2023)Streaming Algorithms for Constrained Submodular MaximizationACM SIGMETRICS Performance Evaluation Review10.1145/3606376.359357351:1(65-66)Online publication date: 27-Jun-2023
https://dl.acm.org/doi/10.1145/3606376.3593573
Show More Cited By

Index Terms

DocWizards: a system for authoring follow-me documentation wizards
1. Human-centered computing
  1. Human computer interaction (HCI)

Recommendations

Haddock, a Haskell documentation tool
Haskell '02: Proceedings of the 2002 ACM SIGPLAN workshop on Haskell

This 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 synthesis

Abstract: 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 Maintenance

In 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

Information & Contributors

Information

Published In

cover image ACM Conferences

UIST '05: Proceedings of the 18th annual ACM symposium on User interface software and technology

October 2005

270 pages

ISBN:1595932712

DOI:10.1145/1095034

General Chairs:
Patrick Baudisch
Microsoft Research
,
Mary Czerwinski
Microsoft Research
,
Program Chair:
Dan Olsen
Brigham Young University, Provo, UT

Copyright © 2005 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: 23 October 2005

Permissions

Request permissions for this article.

Request Permissions

Check for updates

Author Tags

Qualifiers

Article

Conference

UIST05

Sponsor:

UIST05: The 18th Annual ACM Symposium on User Interface Software and Technology

October 23 - 26, 2005

WA, Seattle, USA

Acceptance Rates

UIST '05 Paper Acceptance Rate 31 of 159 submissions, 19%;

Overall Acceptance Rate 561 of 2,567 submissions, 22%

Upcoming Conference

UIST '25

Sponsor:
sigchi
sigchi

The 38th Annual ACM Symposium on User Interface Software and Technology

September 28 - October 1, 2025

Busan , Republic of Korea

Contributors

Other Metrics

View Article Metrics

Bibliometrics & Citations

Bibliometrics

Article Metrics

88
Total Citations
View Citations
843
Total Downloads

Downloads (Last 12 months)13
Downloads (Last 6 weeks)2

Reflects downloads up to 18 Feb 2025

Other Metrics

View Author Metrics

Citations

Cited By

Wali AMahamad SSulaiman S(2023)Task Automation Intelligent Agents: A ReviewFuture Internet10.3390/fi1506019615:6(196)Online publication date: 29-May-2023
https://doi.org/10.3390/fi15060196
Williams JHarchol-Balter MWang W(2023)The M/M/k with Deterministic Setup TimesACM SIGMETRICS Performance Evaluation Review10.1145/3606376.359357551:1(75-76)Online publication date: 27-Jun-2023
https://dl.acm.org/doi/10.1145/3606376.3593575
Cui SHan KTang JHuang HLi XLi Z(2023)Streaming Algorithms for Constrained Submodular MaximizationACM SIGMETRICS Performance Evaluation Review10.1145/3606376.359357351:1(65-66)Online publication date: 27-Jun-2023
https://dl.acm.org/doi/10.1145/3606376.3593573
Rutten DChristianson NMukherjee DWierman A(2023)Smoothed Online Optimization with Unreliable PredictionsACM SIGMETRICS Performance Evaluation Review10.1145/3606376.359357051:1(71-72)Online publication date: 27-Jun-2023
https://dl.acm.org/doi/10.1145/3606376.3593570
Vial DShakkottai SSrikant R(2023)Robust Multi-Agent Bandits Over Undirected GraphsACM SIGMETRICS Performance Evaluation Review10.1145/3606376.359356751:1(67-68)Online publication date: 27-Jun-2023
https://dl.acm.org/doi/10.1145/3606376.3593567
Hu XHuang YLiu BWu RHu YQuigley AFan MYu CShi Y(2023)SmartRecorder: An IMU-based Video Tutorial Creation by Demonstration System for Smartphone Interaction TasksProceedings of the 28th International Conference on Intelligent User Interfaces10.1145/3581641.3584069(278-293)Online publication date: 27-Mar-2023
https://dl.acm.org/doi/10.1145/3581641.3584069
Wang AHead AZhang AOney SBrooks C(2023)Colaroid: A Literate Programming Approach for Authoring Explorable Multi-Stage TutorialsProceedings of the 2023 CHI Conference on Human Factors in Computing Systems10.1145/3544548.3581525(1-22)Online publication date: 19-Apr-2023
https://dl.acm.org/doi/10.1145/3544548.3581525
Mahadevan KZhou QFitzmaurice GGrossman TAnderson F(2023)Tesseract: Querying Spatial Design Recordings by Manipulating Worlds in MiniatureProceedings of the 2023 CHI Conference on Human Factors in Computing Systems10.1145/3544548.3580876(1-16)Online publication date: 19-Apr-2023
https://dl.acm.org/doi/10.1145/3544548.3580876
Stoiber CWagner MGrassinger FPohl MStitz HStreit MPotzmann BAigner W(2023)Visualization Onboarding Grounded in Educational TheoriesVisualization Psychology10.1007/978-3-031-34738-2_6(139-164)Online publication date: 7-Nov-2023
https://doi.org/10.1007/978-3-031-34738-2_6
De Main AXie BShiroma KYeh TDavis NHan X(2022)Assessing the Effects of eHealth Tutorials on Older Adults’ eHealth LiteracyJournal of Applied Gerontology10.1177/0733464822108828141:7(1675-1685)Online publication date: 24-Apr-2022
https://doi.org/10.1177/07334648221088281
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