Documenting after the fact: Recovering architectural design decisions

Journal of Systems and Software

Volumn 81, Issue 4, 2008, Pages 536-557

  Jansen, Anton ^a   Bosch, Jan ^b   Avgeriou, Paris ^a  

^a UNIVERSITY OF GRONINGEN   (Netherlands)

^b Intuit Inc   (United States)

Author keywords

Architectural design decisions; Software architecture recovery

Indexed keywords

COMMUNICATION SYSTEMS; DECISION MAKING; PROGRAM DOCUMENTATION; SOFTWARE DESIGN;

ARCHITECTURAL DESIGN DECISIONS; SOFTWARE ARCHITECTURE RECOVERY; TRACEABILITY;

SOFTWARE ARCHITECTURE;

EID: 40049088606     PISSN: 01641212     EISSN: None     Source Type: Journal    
DOI: 10.1016/j.jss.2007.08.025     Document Type: Article

References (75)

1. G. Arango L. Bruneau J.F. Cloarec A. Feroldi A tool shell for tracking design decisions IEEE Software 8 2 1991 75 83
2. M. Babar I. Gorton B. Kitchenham A framework for supporting architecture knowledge and rationale management A.H. Dutoit R. McCall I. Mistrík B. Paech Rationale Management in Software Engineering 2006 Springer-Verlag 237 254 Ch. 11
3. Baniassad, E.L.A., Murphy, G.C., Schwanninger, C., 2003. Design pattern rationale graphs: linking design to source. In: Proceedings of the 25th ICSE, pp. 352–362.
4. L. Bass P. Clements R. Kazman Software Architecture in Practice 1998 Addison Wesley
5. L. Bass P. Clements R. Kazman Software Architecture in Practice second ed. 2003 Addison Wesley
6. L. Bass P. Clements R.L. Nord J. Stafford Capturing and using rationale for a software architecture A.H. Dutoit R. McCall I. Mistrik B. Paech Rationale Management in Software Engineering 2006 Springer-Verlag 255 272 (Chapter 12)
7. B.W. Boehm E. Horowitz R. Madachy D. Reifer B.K. Clark B. Steece A.W. Brown S. Chulani C. Abts Software Cost Estimation with Cocomo II 2000 Prentice-Hall
8. G. Booch J. RumBaugh I. Jacobson The Unified Modeling Language User Guide 1998 Addison Wesley
9. J. Bosch Software Architecture: The Next Step Software Architecture, First European Workshop (EWSA) LNCS vol. 3047 2004 Springer 194 199
10. Burge, J.E., Brown, D.C., 2004. An integrated approach for software design checking using design rationale. In: Proceedings of the First International Conference on Design Computing and Cognition (DCC’04), pp. 557–576.
11. F. Buschmann R. Meunier H. Rohnert P. Sommerlad M. Stal A System of Patterns 1996 John Wiley & Sons Inc
12. R. Capilla F. Nava S. Pérez J.C. Dueñas A web-based tool for managing architectural design decisions SIGSOFT Software Engineering Notes 31 5 2006 4
13. A. Cimitile A. De Lucia G.A. Di Lucca A.R. Fasolino Identifying objects in legacy systems using design metrics Journal of Systems and Software 44 3 1999 199 211
14. P. Clements F. Bachmann L. Bass D. Garlan J. Ivers R. Little R. Nord J. Stafford Documenting Software Architectures, Views and Beyond 2002 Addison Wesley
15. E.J. Conklin K.B. Yakemovic A process-oriented approach to design rationale Human–Computer Interaction 6 3/4 1991
16. J. Conklin M.L. Begeman Gibis: a tool for all reasons Journal of the American Society for Information Science 40 3 1989 200 213
17. V. Dhar M. Jarke Dependency directed reasoning and learning in systems maintenance support IEEE Transactions on Software Engineering 14 2 1988 211 227
18. T. Eisenbarth R. Koschke D. Simon Aiding program comprehension by static and dynamic feature analysis Proceedings of the International Conference on Software Maintenance (ICSM’01) 2001 IEEE Computer Society 602 611 November
19. D. Falessi G. Cantone M. Becker Documenting design decision rationale to improve individual and team design decision making: an experimental evaluation Proceedings of the 2006 ACM/IEEE International Symposium on Empirical Software Engineering (ISESE’06) 2006 ACM Press New York, NY, USA 134 143
20. L. Feijs R. Krikhaar R. van Ommering A relational approach to support software architecture analysis Software – Practice and Experience 28 4 1998 371 400
21. E. Gamma R. Helm R. Johnson J. Vlissides Design Patterns – Elements of Reusable Object-Oriented Software 1994 Addison Wesley
22. R. Godin G. Mineau R. Missaoui M. St-Germain N. Faraj Applying concept formation to software reuse International Journal of Software Engineering and Knowledge Engineering 5 1 1995 119 142
23. Y.-G. Gueheneuc A systematic study of uml class diagram constituents for their abstract and precise recovery Proceedings of the 11th Asia-Pacific Software Engineering Conference (APSEC’04) 2004 IEEE Computer Society 265 274
24. N.B. Harrison P. Avgeriou U. Zdun Architecture patterns as mechanisms for capturing architectural decisions IEEE Software 24 4 2007 38 45 ISSN 0704-7459
25. C. Hofmeister P. Kruchten R.L. Nord H. Obbink A. Ran P. America Generalizing a model of software architecture design from five industrial approaches Proceedings of the Fifth IEEE/IFIP Working Conference on Software Architecture (WICSA 2005) 2005 IEEE Computer Society 77 88
26. C. Hofmeister R. Nord D. Soni Applied Software Architecture 2000 Addison Wesley
27. C. Hofmeister R.L. Nord D. Soni Global analysis: moving from software requirements specification to structural views of the software architecture IEE Proceedings Software August 2005 187 197
28. IEEE/ANSI, 2000. Recommended Practice for Architectural Description of Software-Intensive Systems. IEEE Standard No. 1471-2000, Product No. SH94869-TBR.
29. V. Jakobac A. Egyed N. Medvidovic Improving system understanding via interactive, tailorable, source code analysis M. Cerioli FASE Lecture Notes in Computer Science vol. 3442 2005 Springer 253 268
30. Jansen, A.G.J., 2004. Athena, a large scale programming lab support tool. In: Proceedings of the Dutch National Computer Science Education Congress (NIOC). Uitgeverij Passage, pp. 83–89.
31. A.G.J. Jansen J. Bosch Evaluation of tool support for architectural evolution Proceedings of the 19th IEEE International Conference on Automated Software Engineering (ASE 2004) 2004 IEEE 375 378
32. Jansen, A.G.J., Bosch, J., 2005. Software architecture as a set of architectural design decisions. In: Proceedings of the Fifth IEEE/IFIP Working Conference on Software Architecture (WICSA 2005), pp. 109–119.
33. Jansen, A.G.J., van der Ven, J., Avgeriou, P., Hammer, D.K., 2007. Tool support for architectural decisions. In: Proceedings of the Sixth IEEE/IFIP Working Conference on Software Architecture (WICSA 2007).
34. Jansen, A.G.J., van Gurp, J., Bosch, J., 2003. Reconstructing architectural design decisions: a case study. Tech. Rep. IWI preprint 2003-7-02, Department of Mathematics and Computing Science, University of Groningen, PO Box 800, 9700 AV, The Netherlands.
35. R.K. Keller R. Schauer S. Robitaille P. Page Pattern-based reverse-engineering of design components Proceedings of the 21st International Conference on Software Engineering (ICSE 1999) 1999 IEEE Computer Society 226 235 May
36. Krikhaar, R.L., Postma, A., Sellink, A., Stroucken, M., Verhoef, C., 1999. A two-phase process for software architecture improvement. In: Proceedings of the International Conference on Software Maintenance (ICSM99), pp. 371–380.
37. P. Kruchten The 4+1 view model of architecture IEEE Software 12 6 1995 42 50
38. Kruchten, P., 2004. An ontology of architectural design decisions in software intensive systems. In: Proceedings of the second Groningen Workshop on Software Variability, pp. 54–61.
39. Kruchten, P., Lago, P., van Vliet, H., 2006. Building up and reasoning about architectural knowledge. In: Proceedings of the Second International Conference on the Quality of Software Architectures (QoSA 2006).
40. Kunz, W., Rittel, H.W.J., 1970. Issues as elements of information systems. Tech. Rep. Working Paper 131.
41. P. Lago P. Avgeriou First workshop on sharing and reusing architectural knowledge SIGSOFT Software Engineering Notes 31 5 2006 32 36
42. P. Lago H. van Vliet Explicit assumptions enrich architectural models ICSE’05: Proceedings of the 27th International Conference on Software Engineering 2005 ACM Press New York, NY, USA 206 214
43. A. Lakhotia A unified framework for expressing software subsystem classification techniques Journal of Systems and Software 36 3 1997 211 231
44. J. Lee Extending the potts and bruns model for recording design rationale Proceedings of the 13th International Conference on Software Engineering (ICSE 1991) 1991 IEEE 114 125
45. N. Medvidovic R.N. Taylor A classification and comparison framework for software architecture description languages IEEE Transactions on Software Engineering 26 1 2000 70 93
46. N.C. Mendonça J. Kramer Developing an approach for the recovery of distributed software architectures Proceedings of the Sixth IEEE International Workshop on Program Comprehension 1998 IEEE Ischia, Italy 28 36 The paper describes the initial work on the X-ray architecture recovery approach and tools
47. I. Nonaka A dynamic theory of organizational knowledge creation Organization Science 5 1 1994 14 37
48. I. Nonaka H. Takeuchi The Knowledge-Creating Company: How Japanese Companies Create the Dynamics of Innovation 1995 Oxford University Press Inc. USA
49. D. Ohst M. Welle U. Kelter Differences between versions of uml diagrams Proceedings of the 9th European software engineering conference held jointly with 10th ACM SIGSOFT international symposium on Foundations of software engineering 2003 ACM Press 227 236
50. P. Oreizy N. Medvidovic R.N. Taylor Architecture-based runtime software evolution Proceedings of the 20th International Conference on Software Engineering (ICSE 1998) 1998 IEEE 177 186
51. D.L. Parnas P.C. Clements A rational design process: How and why to fake it IEEE Transactions on Software Engineering 12 2 1986 251 257
52. D.E. Perry A.L. Wolf Foundations for the study of software architecture ACM SIGSOFT Software Engineering Notes 17 4 1992 40 52
53. Petrie, C., 1992. Constrained decision revision. In: Proceedings of the 10th AAAI Conference, pp. 393–400.
54. C. Potts G. Bruns Recording the reasons for design decisions Proceedings of the 10th International Conference on Software Engineering (ICSE 1988) 1988 IEEE 418 427
55. T. Qin L. Zhang Z. Zhou D. Hao J. Sun Discovering use cases from source code using the branch-reserving call graph Proceedings of the 10th Asia-Pacific Software Engineering Conference Software Engineering Conference (APSEC) 2003 IEEE Computer Society Washington, DC, USA 60
56. B. Ramesh V. Dhar Supporting systems development by capturing deliberations during requirements engineering IEEE Transactions on Software Engineering 18 6 1992 498 510
57. W. Regli X. Hu M. Atwood W. Sun A survey of design rationale systems: approaches, representation, capture and retrieval Engineering with Computers 16 3-4 2000 209 235
58. M.P. Robillard G.C. Murphy Concern graphs: finding and describing concerns using structural program dependencies ICSE’02: Proceedings of the 24th International Conference on Software Engineering 2002 ACM Press New York, NY, USA 406 416
59. M.P. Robillard G.C. Murphy Representing concerns in source code ACM Transactions on Software Engineering and Methodology 16 1 2007 3
60. R. Roshandel A.V.D. Hoek M. Mikic-Rakic N. Medvidovic Mae—a system model and environment for managing architectural evolution ACM Transactions on Software Engineering and Methodology 13 2 2004 240 276
61. M. Shaw D. Garlan Software Architecture: Perspectives on an Emerging Discipline 1996 Prentice-Hall Inc
62. G. Snelting F. Tip Reengineering class hierarchies using concept analysis Proceedings of the 6th ACM SIGSOFT international symposium on Foundations of software engineering 1998 ACM Press 99 110
63. Stepenson, Z.R., 2002. Change management in families of safety-critical embedded systems. Ph.D. thesis, University of York.
64. Tang, A., Babar, M.A., Gorton, I., Han, J., 2005. A survey of the use and documentation of architecture design rationale. In: Proceeding of the Fifth Working IEEE/IFIP Conference on Software Architecture (WICSA 2005), pp. 89–99.
65. Tonella, P., Potrich, A., October 2002. Static and dynamic C++ code analysis for the recovery of the object diagram. In: Proceedings of the International Conference on Software Maintenance, pp. 54–63.
66. J. Tyree A. Akerman Architecture decisions: demystifying architecture IEEE Software 22 2 2005 19 27
67. V. Tzerpos R.C. Holt ACDC: an algorithm for comprehension-driven clustering Working Conference on Reverse Engineering (WCRE 2000) 2000 IEEE Computer Society 258 267
68. J.S. van der Ven A.G.J. Jansen J.A.G. Nijhuis J. Bosch Design decisions: the bridge between rationale and architecture A.H. Dutoit R. McCall I. Mistrik B. Paech Rationale Management in Software Engineering 2006 Springer-Verlag 329 348 (Chapter 16)
69. A. van Deursen Software architecture recovery and modelling: [wcre 2001 discussion forum report] ACM SIGAPP Applied Computing Review 10 1 2002 4 7
70. A. van Deursen C. Hofmeister R. Koschke L. Moonen C. Riva Symphony: view-driven software architecture reconstruction Proceedings of the 4th IEEE/IFIP Working Conference on Software Architecture (WICSA 2004) 2004 IEEE Computer Society 122
71. A. van Deursen T. Kuipers Identifying objects using cluster and concept analysis Proceedings of the 21st International Conference on Software Engineering, ICSE-99 1999 ACM 246 255
72. M. Visconti C.R. Cook Assessing the state of software documentation practices F. Bomarius H. Iida PROFES Lecture Notes in Computer Science vol. 3009 2004 Springer 485 496
73. Webster, 2006. http://www.webster.com .
74. T. Wiggerts H. Bosma E. Fielt Scenarios for the identification of objects in legacy systems Fourth Working Conference on Reverse Engineering (WCRE’97) 1997 IEEE Computer Society 24 32
75. H. Yan D. Garlan B.R. Schmerl J. Aldrich R. Kazman Discotect: a system for discovering architectures from running systems Proceedings of the 26th International Conference on Software Engineering (ICSE 2004) 2004 IEEE Computer Society 470 479