JTourBus: Simplifying Program Understanding by Documentation that Provides Tours Through the Source Code
- 1 October 2007
- conference paper
- Published by Institute of Electrical and Electronics Engineers (IEEE) in 2007 IEEE International Conference on Software Maintenance
- No. 10636773,p. 64-73
Abstract
Many small and medium-sized systems have little or no design documentation, which makes program understanding during maintenance enormously more difficult when performed by outsiders. Thus, if only minimal design documentation is available, which form should it take to maximize its usefulness? We suggest that it is helpful if the documentation describes a tour through the source code, leading the user directly to relevant details. This work reports an evaluation of this conceptual idea in the form of a controlled experiment with 59 student subjects working on a difficult program understanding task in the context of the 27 KLOC JHotDraw graphics framework. One group received a plain text documentation, the other received tour-structured documentation which they navigated by using an Eclipse plugin called JTourBus that we constructed for the experiment. The results indicate that program understanding can be achieved somewhat faster (albeit not more correctly) with JTourBus than with a plain text document.Keywords
This publication has 8 references indexed in Scilit:
- Shared waypoints and social tagging to support collaboration in software development2006
- Role-based refactoring of crosscutting concerns2005
- A Qualitative Comparison of Three Aspect Mining Techniques2005
- Theories, methods and tools in program comprehension: past, present and future2005
- Practices of software maintenance2002
- Concern graphs2002
- Program understanding behavior during corrective maintenance of large-scale softwareInternational Journal of Human-Computer Studies, 1999
- Designing documentation to compensate for delocalized plansCommunications of the ACM, 1988