Live documents with contextual, data-driven information components

We introduce the notion of a live document and we describe our concept of live documents with contextual, data driven information components. The dynamic and interactive features of live documents provide a consistent data source for multimedia presentations targeted to various audiences and multiple platforms. Therefore, they contribute to the solution of key challenges in single sourcing and repurposing. We motivate the use of live documents with sample scenarios from the field of systems documentation. We further discuss how live documents can benefit from an interdisciplinary research approach across the fields of technical communications, systems documentation, and software engineering. Finally, cit_af ref_bf(Greenberg, Saul 2001 ref_num129)ref_we describe our experiences with prototype implementations of live documents based on Scalable Vector Graphics (SVG) and Microsoft Office Automation, respectively.

[1]  Michael Priestley.  Dynamically assembled documentation , 1999, SIGDOC '99.

[2]  Chris F. Kemerer,et al.  Now the learning curve affects CASE tool adoption , 1992, IEEE Software.

[3]  Saul Greenberg,et al.  Context as a Dynamic Construct , 2001, Hum. Comput. Interact..

[4]  Audris Mockus,et al.  Web-based text visualization , 1998 .

[5]  Patti Anklam.  Technical communications as knowledge management: evolution of a profession , 1999, SIGDOC '99.

[6]  Mayer D. Schwartz,et al.  Contexts: a partitioning concept for hypertext , 1986, CSCW '86.

[7]  Audris Mockus,et al.  A Web-based approach to interactive visualization in context , 2000, AVI '00.

[8]  James C. French,et al.  A systematic approach to creating and maintaining software documentation , 1996, SAC '96.

[9]  Scott R. Tilley,et al.  Documenting-in-the-large vs. documenting-in-the-small , 1993, CASCON.

[10]  Robert Mathews,et al.  Developing a user information architecture for Rational's ClearCase product family documentation set , 1999, SIGDOC '99.

[11]  Scott R. Tilley.  Management decision support through reverse engineering technology , 1992, CASCON.

[12]  Hausi A. Müller,et al.  Rigi: a system for programming-in-the-large , 1988, Proceedings. [1989] 11th International Conference on Software Engineering.

[13]  Juhani Iivari,et al.  Why are CASE tools not used? , 1996, CACM.

[14]  Carl Stieren.  Add one egg, a cup of milk, and stir: single source documentation for today , 1997, SIGDOC '97.

[15]  William W. Wadge,et al.  A Complementary Approach for Adaptive and Adaptable Hypermedia: Intensional Hypertext , 2001, OHS-7/SC-3/AH-3.

[16]  Audris Mockus,et al.  A Web laboratory for software data analysis , 2004, World Wide Web.

[17]  Andrew Walenstein,et al.  Theory-based analysis of cognitive support in software comprehension tools , 2002, Proceedings 10th International Workshop on Program Comprehension.

[18]  James H. Cross,et al.  Reverse engineering and design recovery: a taxonomy , 1990, IEEE Software.

[19]  Glenn McAllister.  The developer-documenter relationship in Java software development , 1999, SIGDOC '99.

[20]  Audris Mockus,et al.  Flexible Information Visualization Components for Authoring WWW Live Documents , 1999 .

[21]  Sophia Ananiadou,et al.  Terminological acquaintance: The importance of contextual information in terminology , 2000 .

[22]  Robert Balzer,et al.  The Briefing Associate: Easing Authors into the Semantic Web , 2002, IEEE Intell. Syst..

[23]  Susan Korgen.  Object-oriented, single-source, on-line documents that update themselves , 1996, SIGDOC '96.

[24]  Robin Green.  Component-based software development: implications for documentation , 1999, SIGDOC '99.

[25]  Rick Sobiesiak,et al.  Towards a new generation of authoring tools , 1996, SIGDOC '95.

[26]  Kenny Wong,et al.  The reverse engineering notebook , 1999 .

[27]  Robert Wilensky,et al.  Multivalent documents , 2000, CACM.

[28]  Karl A. Hakkarainen.  Unifying documentation teams , 1999, SIGDOC '99.