Illustrating Macros with Existing Documentation Export

@techreport{CreswickEtAl2005:MacroIllustrator, abstract = {This paper presents an approach that enlivens existing documentation, to efficiently support users performing procedural tasks. We describe an approach that automatically creates, in real-time, correspondences between the actions performed by users and the steps described in online documentation for the procedure being performed. Using these correspondences, our Macro Illustrator system can highlight the relevant portions of the documentation and provide the user with a visual indication of the progress being made. Users are therefore offered in-context documentation, which helps them track their current position in the procedure, and answers questions about the next steps to be taken. This approach works with existing documentation, requiring no additional markup on the part of the documentation author. We present an algorithm for extracting actions from documentation and aligning these extracted document actions with observed user actions through a system of similarity metrics. Empirical evaluation of this algorithm shows that it performs significantly better than a strawman approach.}, address = {Hawthorne, NY}, author = {Creswick, Eugene R. and Bergman, Lawrence and Lau, Tessa A. and Castelli, Vittorio and Oblinger, Daniel A.}, citeulike-article-id = {1084663}, institution = {IBM TJ Watson}, keywords = {concept\_extraction, pbd}, month = {August}, posted-at = {2007-02-02 17:14:58}, priority = {0}, title = {Illustrating Macros with Existing Documentation}, volume = {RC236696}, year = {2005} }

TY - RPRT ID - CreswickEtAl2005:MacroIllustrator L3 - citeulike-article-id:1084663 N2 - This paper presents an approach that enlivens existing documentation, to efficiently support users performing procedural tasks. We describe an approach that automatically creates, in real-time, correspondences between the actions performed by users and the steps described in online documentation for the procedure being performed. Using these correspondences, our Macro Illustrator system can highlight the relevant portions of the documentation and provide the user with a visual indication of the progress being made. Users are therefore offered in-context documentation, which helps them track their current position in the procedure, and answers questions about the next steps to be taken. This approach works with existing documentation, requiring no additional markup on the part of the documentation author. We present an algorithm for extracting actions from documentation and aligning these extracted document actions with observed user actions through a system of similarity metrics. Empirical evaluation of this algorithm shows that it performs significantly better than a strawman approach. AD - Hawthorne, NY TI - Illustrating Macros with Existing Documentation VL - RC236696 KW - concept_extraction KW - pbd AU - Creswick, Eugene AU - Bergman, Lawrence AU - Lau, Tessa AU - Castelli, Vittorio AU - Oblinger, Daniel PY - 2005/08// ER -