A documentation framework for architecture decisions

Journal of Systems and Software

Volumn 85, Issue 4, 2012, Pages 795-820

  Van Heesch, U ^a,b   Avgeriou, P ^a   Hilliard, R ^c  

^a UNIVERSITY OF GRONINGEN   (Netherlands)

^b FONTYS UNIVERSITY OF APPLIED SCIENCES   (Netherlands)

^c Consulting Software Systems Architect ^*  (United States)

Author keywords

Architectural viewpoints; Architecture decisions; Architecture framework; Architecture knowledge management; Case study; Software architecture

Indexed keywords

KNOWLEDGE MANAGEMENT; SOFTWARE ARCHITECTURE;

ARCHITECTURAL VIEWPOINTS; ARCHITECTURE DECISIONS; ARCHITECTURE FRAMEWORKS; ARCHITECTURE KNOWLEDGE MANAGEMENTS; INDUSTRIAL CASE STUDY; INTERNATIONAL STANDARDS; STAKEHOLDER INVOLVEMENT;

DECISION MAKING;

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

References (40)

1. Babar M.A.; Dingsyr T.; Lago P.; and van Vliet H. Software Architecture Knowledge Management: Theory and Practice 2009 Springer Publishing Company, Incorporated
2. Bosch J. Software architecture: the next step Software architecture, First European Workshop (EWSA) 2004 (3047 of LNCS:194-199)
3. Capilla R.; Nava F.; and Dueñas J.C. Modeling and documenting the evolution of architectural design decisions Proceedings of the Second Workshop on SHAring and Reusing architectural Knowledge Architecture, Rationale, and Design Intent 2007 IEEE Computer Society 9
4. Clements P.; Garlan D.; Bass L.; Stafford J.; Nord R.; Ivers J.; and Little R. Documenting Software Architectures: Views and Beyond 2002 Pearson Education
5. University of Groningen, Software Engineering and Architecture Group, The Open Pattern Repository. http://code.google.com/p/openpatternrepository/, February 2011.
6. Dueñas J.; and Capilla R. The decision view of software architecture Morrison R. Oquendo F. Software Architecture, volume 3527 of Lecture Notes in Computer Science 2005 Springer Berlin/Heidelberg 88 126
7. Glaser B.G.; and Strauss A.L. The Discovery of Grounded Theory: Strategies for Qualitative Research 1967 Aldine Publishing New York
8. Gray D.E. Doing Research in the Real World 2009 Sage Publications Ltd.
9. IEEE. IEEE Std 1471-2000, IEEE Recommended Practice for Architectural Description of Software-Intensive Systems, October 2000.
10. IEEE, 2008. IEEE Std 1028-2008, IEEE Standard for Software Reviews and Audits.
11. ISO, May 2011. Systems and Software Engineering - Architecture Description. ISO/IEC/IEEE 42010, pp. 1-46.
12. Jansen A.; and Bosch J. Software architecture as a set of architectural design decisions Proceedings of the 5th Working IEEE/IFIP Conference on Software Architecture 2005 IEEE Computer Society 109 120 (Pubitemid 46401931)
13. Jansen A.; van der Ven J.; Avgeriou P.; and Hammer D.K. Tool support for architectural decisions Proceedings of the Sixth Working IEEE/IFIP Conference on Software Architecture 2007 IEEE Computer Society 4
14. Kontio J.; Lehtola L.; and Bragge J. Using the focus group method in software engineering: obtaining practitioner and user experiences Proceedings of the 2004 International Symposium on Empirical Software Engineering 2004 IEEE Computer Society 271 280 (Pubitemid 40062839)
15. Kruchten P.; Lago P.; and van Vliet H. Building up and reasoning about architectural knowledge Hofmeister C. Crnkovic I. Reussner R. Quality of Software Architectures, volume 4214 of Lecture Notes in Computer Science 2006 Springer Berlin/Heidelberg 43 58
16. Kruchten P.; Capilla R.; and Dueñas J.C. The decision view's role in software architecture practice IEEE Software 26 2 2009 36 42
17. Kruchten P. The 4+1 View Model of architecture IEEE Software 12 6 1995 42 50
18. Kruchten P. An ontology of architectural design decisions in software intensive systems Proceedings of the 2nd Groningen Workshop on Software Variability 2004 54 61
19. Lee L.; and Kruchten P. A tool to visualize architectural design decisions Proceedings of the 4th International Conference on Quality of Software-Architectures: Models and Architectures 2008 Springer-Verlag 43 54
20. Lethbridge T.C.; Sim S.E.; and Singer J. Studying software engineers: data collection techniques for software field studies Empirical Software Engineering 10 2005 311 341 (Pubitemid 40940550)
21. Liang P.; and Avgeriou P. Tools and technologies for architecture knowledge management Software Architecture Knowledge Management: Theory and Practice 2009 Springer 91 111
22. Liang, P.; Jansen, A.; Avgeriou, P.; February 2009. Knowledge Architect: A Tool Suite for Managing Software Architecture Knowledge. Technical Report RUG-SEARCH-09-L01, SEARCH Group, University of Groningen, The Netherlands.
23. Mack N.; Woodsong C.; MacQueen K.M.; Guest G.; and Namey E. Qualitative Research Methods: A Data Collector's Field Guide 2005 FLI
24. MacLean A.; Young R.M.; Bellotti V.M.E.; and Moran T.P. Questions, options, and criteria: elements of design space analysis Human-Computer Interaction 6 3 1991 201 250
25. University of Groningen, Software Engineering and Architecture Group, The Open Decision Repository. http://opendecisionrepository.googlecode.com, February 2011.
26. Perry D.E.; and Wolf A.L. Foundations for the study of software architecture ACM SIGSOFT Software Engineering Notes 17 4 1992 40 52
27. Robson C. Real World Research: A Resource for Social Scientists and Practitioner-Researchers 2002 Wiley-Blackwell
28. Rossow C.; Dietrich C.J.; Bos H.; Cavallaro L.; van Steen M.; Freiling F.C.; and Pohlmann N. Sandnet: network traffic analysis of malicious software Building Analysis Datasets and Gathering Experience Returns for Security 2011
29. Rozanski N.; and Woods E. Software Systems Architecture: Working with Stakeholders using Viewpoints and Perspectives 2005 Addison-Wesley Professional
30. Runeson P.; and Hoest M. Guidelines for conducting and reporting case study research in software engineering Empirical Software Engineering 14 2009 131 164
31. Seaman C.B. Qualitative methods in empirical studies of software engineering IEEE Transactions on Software Engineering 25 4 1999 557 572
32. Shahin M.; Liang P.; and Khayyambashi M.R. Architectural design decision: existing models and tools European Conference on Software Architecture. WICSA/ECSA 2009. Joint Working IEEE/IFIP Conference on Software Architecture, 2009 2009 IEEE 293 296
33. Shahin M.; Liang P.; and Khayyambashi M.R. Improving understandability of architecture design through visualization of architectural design decision Proceedings of the 2010 ICSE Workshop on Sharing and Reusing Architectural Knowledge 2010 ACM 88 95
34. Stake R.E. The Art of Case Study Research 1995 Sage Publications, Inc.
35. Tang A.; Avgeriou P.; Jansen A.; Capilla R.; and Ali Babar M. A comparative study of architecture knowledge management tools Journal of Systems and Software 83 3 2010 352 370
36. Tyree J.; and Akerman A. Architecture decisions: demystifying architecture IEEE Software 22 2 2005 19 27 (Pubitemid 40556015)
37. Williams, R.C.; Pandelios, G.J.; Behrens, S.G.; 1999. Software Risk Evaluation (SRE) Method Description (Version 2.0). Technical Report CMU/SEI-99-TR-029, ESC-TR-99-029, Software Engineering Institute, Carnegie Mellon University, December 1999.
38. Wohlin C.; Runeson P.; Höst M.; Ohlsson M.C.; Regnell B.; and Wesslén A. Experimentation in Software Engineering: An Introduction 2000 Kluwer Academic Publishers
39. Wohlin C.; Hoest M.; and Henningsson K. Empirical research methods in software engineering Conradi R. Wang A. Empirical Methods and Studies in Software Engineering, volume 2765 of Lecture Notes in Computer Science 2003 Springer Berlin/Heidelberg 145 165
40. Yin R.K. Case Study Research: Design and Methods, Applied Social Research Methods Series, vol. 5 third edition February 2003 Sage Publications, Inc.