Interactive explanation of software systems
- 19 November 2002
- conference paper
- Published by Institute of Electrical and Electronics Engineers (IEEE)
- p. 155-164
- https://doi.org/10.1109/kbse.1995.490131
Abstract
This paper describes an effort to provide automated support for the interactive inquiry and explanation process that is at the heart of software understanding. A hypermedia tool called I-Doc allows software engineers to post queries about a software system, and generates focused explanations in response. These explanations are task-oriented, i.e., they are sensitive to the software engineering task being performed by the user that led to the query. Task orientation leads to more effective explanations, and is particularly helpful for understanding large software systems. Empirical studies of inquiry episodes were conducted in order to investigate this claim; the kinds of questions users ask, their relation to the user's task and level of expertise. The I-Doc tool is being developed to embody these principles, employing knowledge-based techniques. The presentation mechanism employs World Wide Web (WWW) technology, making it suitable for widespread use.Keywords
This publication has 11 references indexed in Scilit:
- Layered explanations of software: a methodology for program comprehensionPublished by Institute of Electrical and Electronics Engineers (IEEE) ,2002
- Using generalized markup and SGML for reverse engineering graphical representations of softwarePublished by Institute of Electrical and Electronics Engineers (IEEE) ,2002
- Understanding someone else's code: Analysis of experiencesJournal of Systems and Software, 1993
- Representation and presentation of requirements knowledgeIEEE Transactions on Software Engineering, 1992
- Program understanding: Challenge for the 1990sIBM Systems Journal, 1989
- Designing documentation to compensate for delocalized plansCommunications of the ACM, 1988
- Justified advice: a semi-naturalistic study of advisory strategiesPublished by Association for Computing Machinery (ACM) ,1988
- Issues of Content and Presentation in Document DesignPublished by Elsevier ,1988
- Individual Differences In Human-Computer InteractionPublished by Elsevier ,1988
- Towards a theory of the comprehension of computer programsInternational Journal of Man-Machine Studies, 1983