Advanced Search

Content Type

Topics

Publication Date

Software Architecture Documentation in Practice: Documenting Architectural Layers

Abstract

This report represents the first milestone of a work in progress. That work is a comprehensive handbook on how to produce high-quality documentation for software architectures. The handbook, tentatively entitled Software Architecture Documentation in Practice, will be published in mid- to late-2000 by Addison Wesley Longman as a book in the SEI series on software engineering. Aimed squarely at the practitioner, the handbook is intended to fill a gap in the literature: There is a complete lack of language-independent guidance about how to actually capture an architecture in written form so that it can fulfill its purpose as a communication vehicle providing a unified design vision to all of the varied stakeholders of a development project.  

The theme of the work is that documenting an architecture entails documenting the set of relevant views of that architecture, and then completing the picture with documentation of information that transcends any single view. The report lays out our approach and organization for the complete book, and provides full guidance for one of the most commonly used architectural views: the layer diagram. The audience for this book is the community of practicing architects, apprentice architects, and developers who are on the receiving end of architectural documentation.

Cite This Report

Show Citation Formats

SEI

Bachmann, Felix; Bass, Len; Carriere, S.; Clements, Paul; Garlan, David; Ivers, James; Nord, Robert; & Little, M.. Software Architecture Documentation in Practice: Documenting Architectural Layers (CMU/SEI-2000-SR-004). Software Engineering Institute, Carnegie Mellon University, 2000. http://resources.sei.cmu.edu/library/asset-view.cfm?AssetID=5019

IEEE

Bachmann. Felix, Bass. Len, Carriere. S., Clements. Paul, Garlan. David, Ivers. James, Nord. Robert, and Little. M., "Software Architecture Documentation in Practice: Documenting Architectural Layers," Software Engineering Institute, Carnegie Mellon University, Pittsburgh, Pennsylvania, Special Report CMU/SEI-2000-SR-004, 2000. http://resources.sei.cmu.edu/library/asset-view.cfm?AssetID=5019

APA

Bachmann, Felix., Bass, Len., Carriere, S.., Clements, Paul., Garlan, David., Ivers, James., Nord, Robert., & Little, M.. (2000). Software Architecture Documentation in Practice: Documenting Architectural Layers (CMU/SEI-2000-SR-004). Retrieved July 22, 2014, from the Software Engineering Institute, Carnegie Mellon University website: http://resources.sei.cmu.edu/library/asset-view.cfm?AssetID=5019

CHI

Felix Bachmann, Len Bass, S. Carriere, Paul Clements, David Garlan, James Ivers, Robert Nord, & M. Little. Software Architecture Documentation in Practice: Documenting Architectural Layers (CMU/SEI-2000-SR-004). Pittsburgh, PA: Software Engineering Institute, Carnegie Mellon University, 2000. http://resources.sei.cmu.edu/library/asset-view.cfm?AssetID=5019

MLA

Bachmann, Felix., Bass, Len., Carriere, S.., Clements, Paul., Garlan, David., Ivers, James., Nord, Robert., & Little, M.. 2000. Software Architecture Documentation in Practice: Documenting Architectural Layers (Technical Report CMU/SEI-2000-SR-004). Pittsburgh: Software Engineering Institute, Carnegie Mellon University. http://resources.sei.cmu.edu/library/asset-view.cfm?AssetID=5019