Empirical comparison of graphical and annotation-based re-documentation approaches

IET Software

Volumn 4, Issue 1, 2010, Pages 15-31

  Torchiano, M ^a   Ricca, F ^b   Tonella, P ^c  

^a POLITECNICO DI TORINO   (Italy)

^b UNIVERSITY OF GENOA   (Italy)

^c ITC IRST   (Italy)

Author keywords

[No Author keywords available]

Indexed keywords

CODE ANNOTATION; COMPLEX ACTIVITY; CURRENT LIMITATION; DESIGN INFORMATION; EMPIRICAL COMPARISON; PROCESSING TOOLS; SOURCE CODES;

GRAPHIC METHODS;

RHENIUM COMPOUNDS;

EID: 77950199897     PISSN: 17518806     EISSN: None     Source Type: Journal    
DOI: 10.1049/iet-sen.2009.0015     Document Type: Article

References (39)

1. Corbi, T.A.: ' Program understanding: challenge for the 1990s ', IBM Syst. J., 1989, 28, (2), p. 294-306 0018-8670
2. Rugaber, S.: ' Program comprehension ', Encyclopedia of computer science and technology, (Marcel Dekker, Inc., New York, 1995), 35, p. 341-368, issue 20)
3. Chikofsky, E., and Cross, J.: ' Reverse engineering and design recovery: a taxonomy ', IEEE Softw., 1990, 7, (1), p. 13-17 0740-7459
4. Briand, L.C.: ' The experimental paradigm in reverse engineering: role, challenges, and limitations ', Proc. 13th Working Conf. Reverse Engineering, WCRE, 2006, p. 3-8
5. Omondo home page, available at: http://www.omondo.com, last accessed May 5, 2008
6. Spinellis, D.: ' Drawing UML diagrams with UMLGraph, whitepaper ', 2005, available at: http://www.spinellis.gr/sw/umlgraph/, last accessed October 31, 2007
7. Torchiano, M., Ricca, F., and Tonella, P.: ' A comparative study on the re-documentation of existing software: code annotations vs. drawing editors ', Int. Symp. Empirical Software Engineering (ISESE, 2005), November, 17-18, 2005, p. 277-286
8. Gillis, K.D., and Wright, D.G.: ' Improving software maintenance using system-level reverse engineering ', Proc. Int. Conf. Software Maintenance (ICSM 1990), November, 1990, p. 84-90
9. Miller, G.A.: ' The magical number seven, plus or minus two: some limits on our capacity for processing information ', Psychol. Rev., 1956, 63, p. 81-97
10. Bruegge, B., and Dutoit, A.H.: ' Object-oriented software engineering: conquering complex and changing systems ', (Prentice-Hall, 2000)
11. Eclipse, Eclipse home page, available at: http://www.eclipse.org/, last accessed May 5, 2008
12. Spinellis, D.: ' On the declarative specification of models ', IEEE Softw., 2003, 20, (2), p. 94-96 0740-7459
13. Sun Microsystems Inc., Doclet Overview, available at: http://java.sun.com/j2se/1.5.0/docs/guide/javadoc/doclet/overview.html, last accessed May 5, 2008, 2004
14. Gansner, E.R., and North, S.C.: ' An open graph visualization system and its applications to software engineering ', Softw. Pract. Exp., 30, (11), p. 1203-1233 0038-0644
15. Wohlin, C., Runeson, P., Host, M., Ohlsson, M.C., Regnell, B., and Wesslen, A.: ' Experimentation in software engineering: an introduction ', (Kluwer Academic Publishers, 2000)
16. Juristo, N., and Moreno, A.M.: ' Basics of software engineering experimentation ', (Kluwer Academic Publishers, 2001)
17. Likert, R.: ' A technique for the measurement of attitudes ', Arch. Psychol., 1932, 140, p. 5-55
18. Mann, H.B., and Whitney, D.R.: ' On a test of whether one of two random variables is stochastically larger than the other ', Ann. Math. Stat., 1947, 18, p. 50-60
19. Ricca, F., Di Penta, M., Torchiano, M., Tonella, P., and Ceccato, M.: ' The role of experience and ability in comprehension tasks supported by uml stereotypes ', Proc. Int. Conf. Software Engineering, May, 2007, p. 375-384
20. Karlsson, L., Thelin, T., Regnell, B., Berander, P., and Wohlin, C.: ' Pair-wise comparisons versus planning game partitioning - experiments on requirements prioritisation techniques ', Empir. Softw. Eng., 2007, 12, (1), p. 3-33 10.1007/s10664-006-7240-4, 1382-3256
21. Bratthall, L., and Wohlin, C.: ' Is it possible to decorate graphical software design and architecture models with qualitative information? An experiment ', IEEE Trans. Softw. Eng., 2002, 28, (12), p. 1181-1193 0098-5589
22. Staron, M., Kuzniarz, L., and Wohlin, C.: ' Empirical assessment of using stereotypes to improve comprehension of UML models: a set of experiments ', J. Syst. Softw., 2006, 79, (5), p. 727-742 10.1016/j.jss.2005.09.014 0164-1212
23. Kuzniarz, L., Staron, M., and Wohlin, C.: ' An empirical study on using stereotypes to improve understanding of UML models ', Proc. Int. Workshop Program Comprehension (IWPC), 2004, p. 14-23
24. Arisholm, E., Briand, L.C., Hove, S.E., and Labiche, Y.: ' The impact of UML documentation on software maintenance: an experimental evaluation ', IEEE Trans. Softw. Eng., 2006, 32, (6), p. 365-381 0098-5589
25. Briand, L.C., Labiche, Y., Di Penta, M., and Yan-Bondoc, H.D.: ' An experimental investigation of formality in UML-based development ', IEEE Trans. Softw. Eng., 2005, 31, (10), p. 833-849 10.1109/TSE.2005.105 0098-5589
26. Wong, K., Tilley, S.R., Muller, H.A., and Storey, M.D.: ' Structural redocumentation: a case study ', IEEE Softw., 1995, 12, (1), p. 46-54 0740-7459
27. Antoniol, G., Fiutem, R., Lutteri, G., Tonella, P., and Zanfei, S.: ' Program understanding and maintenance with the CANTO environment ', Proc. Int. Conf. Software Maintenance (ICSM), October, 1-3, 1997, p. 72-81
28. Lanza, M.: ' CodeCrawler-lessons learned in building a software visualization tool ', Proc. CSMR 2003, Seventh Eur. Conf. Software Maintenance and Reengineering, p. 409-418
29. Baxter, I., Pidgeon, P., and Mehlich, M.: ' DMS: program transformations for practical scalable software evolution ', Proc. Int. Conf. Software Engineering, 2004
30. ++ ', Proc. 18th Int. Conf. Software Maintenance (ICSM 2002), October, 3-6, 2002, p. 172-181
31. Tonella, P., Torchiano, M., Du Bois, B., and Systa, T.: ' Empirical studies in reverse engineering: state of the art and future trends ', Empir. Softw. Eng., 2007, 12, (5), p. 551-571 1382-3256
32. Gannod, G.C., and Cheng, B.H.C.: ' A framework for classifying and comparing software reverse engineering and design recovery techniques ', Proc. IEEE Working Conf. Reverse Engineering, 1999, p. 77-88
33. Gueheneuc, Y.-G., Mens, K., and Wuyts, R.: ' A comparative framework for design recovery tools ', 10th, Euro. Conf. Software Maintenance and Reengineering (CSMR 2006), March, 22-24, 2006, p. 123-134
34. van Deursen, A., and Moonen, L.: ' Documenting software systems using types ', Sci. Comput. Program., 2006, 60, (2), p. 202-220 0167-6423
35. Brown, P.: ' Integrated hypertext and program understanding tools ', IBM Syst. J., 1991, 30, (3), p. 363-392 0018-8670
36. Rajlich, V.: ' Incremental redocumentation using the web ', IEEE Softw., 2000, 17, (5), p. 102-106 0740-7459
37. Rajlich, V.: ' Incremental redocumentation with hypertext ', Proc. Conf. Software Maintenance and Reengineering (CSMR 1997), March, 17-19, 1997, p. 68-72
38. Knuth, D.: ' Literate programming ', (CLSI Lecture notes, 1991)
39. 'Comparison of documentation generators', available at: http://en.wikipedia.org/wiki/Comparison-of-documentation-generators last accessed May 5, 2008