skip to main content
10.1145/2993412.3004844acmotherconferencesArticle/Chapter ViewAbstractPublication PagesecsawConference Proceedingsconference-collections
research-article

Towards the essentials of architecture documentation for avoiding architecture erosion

Published:28 November 2016Publication History

ABSTRACT

Software architecture documentation is essential for preventing architecture erosion that is a major concern of sustainable software systems. However, the high effort for elaboration and maintenance of architecture documentation hinders its acceptance in practice. Most state-of-the-art research methods assume comprehensive architecture documentation. By reducing architecture documentation to those aspects that are most important for architecture erosion, we want to achieve more acceptance for architecture documentation especially in agile projects. This reduction, however, has effects on architecture-related activities during software design and implementation.

References

  1. S. Ambler. Agile ModModel. Effective Practices for eXtreme Programming and the Unified Process. John Wiley & Sons, 2002. Google ScholarGoogle ScholarDigital LibraryDigital Library
  2. P. Clements, F. Bachman, L. Bass, D. Garlan, J. Ivers, R. Little, R. Nord, and J. Stafford. Documenting Software Architectures. Views and Beyond. Addison-Wesley Longman, Amsterdam, 2003. Google ScholarGoogle ScholarDigital LibraryDigital Library
  3. I. Hadar, S. Sherman, E. Hadar, and J. J. Harrison. Less is more: Architecture documentation for agile development. In CHASE '13, May 2013.Google ScholarGoogle ScholarCross RefCross Ref
  4. A. Jansen and J. Bosch. Software Architecture as a Set of Architectural Design Decisions. In WICSA '05, 2005. Google ScholarGoogle ScholarDigital LibraryDigital Library
  5. I. Malavolta, P. Lago, H. Muccini, P. Pelliccione, and A. Tang. What Industry Needs from Architectural Languages: A Survey. IEEE Trans. Softw. Eng., 2013. Google ScholarGoogle ScholarDigital LibraryDigital Library
  6. C. Miesbauer and R. Weinreich. Classification of design decisions-an expert survey in practice. In ECSA 2013, pages 130--145. Springer, 2013. Google ScholarGoogle ScholarDigital LibraryDigital Library
  7. D. E. Perry and A. L. Wolf. Foundations for the study of software architecture. SIGSOFT Softw. Eng. Notes, 17(4):40--52, Oct. 1992. Google ScholarGoogle ScholarDigital LibraryDigital Library
  8. S. Schröder, M. Riebisch, and M. Soliman. Architecture enforcement concerns and activities - an expert study. In ECSA '16, 2016.Google ScholarGoogle ScholarCross RefCross Ref
  9. A. Tang, P. Avgeriou, A. Jansen, R. Capilla, and M. Ali Babar. A comparative study of architecture knowledge management tools. J. Syst. Software, 83:352--370, 2010. Google ScholarGoogle ScholarDigital LibraryDigital Library
  10. J. Tyree and A. Akerman. Architecture decisions: Demystifying architecture. IEEE software, 22(2):19--27, 2005. Google ScholarGoogle ScholarDigital LibraryDigital Library
  11. R. Wojcik, F. Bachmann, L. Bass, P. Clements, P. Merson, R. Nord, and B. Wood. Attribute-Driven Design (ADD), Version 2.0. Technical report, CMU/SEI, 2006.Google ScholarGoogle Scholar
  12. O. Zimmermann, T. Gschwind, J. Küster, F. Leymann, and N. Schuster. Reusable architectural decision models for enterprise application development. In QoSA '07, pages 15--32, 2007. Google ScholarGoogle ScholarDigital LibraryDigital Library

Recommendations

Comments

Login options

Check if you have access through your login credentials or your institution to get full access on this article.

Sign in
  • Published in

    cover image ACM Other conferences
    ECSAW '16: Proccedings of the 10th European Conference on Software Architecture Workshops
    November 2016
    234 pages
    ISBN:9781450347815
    DOI:10.1145/2993412

    Copyright © 2016 ACM

    Permission to make digital or hard copies of all or part of this work for personal or classroom use is granted without fee provided that copies are not made or distributed for profit or commercial advantage and that copies bear this notice and the full citation on the first page. Copyrights for components of this work owned by others than the author(s) must be honored. Abstracting with credit is permitted. To copy otherwise, or republish, to post on servers or to redistribute to lists, requires prior specific permission and/or a fee. Request permissions from [email protected].

    Publisher

    Association for Computing Machinery

    New York, NY, United States

    Publication History

    • Published: 28 November 2016

    Permissions

    Request permissions about this article.

    Request Permissions

    Check for updates

    Qualifiers

    • research-article

    Acceptance Rates

    Overall Acceptance Rate80of120submissions,67%

PDF Format

View or Download as a PDF file.

PDF

eReader

View online with eReader.

eReader