search menu icon-carat-right cmu-wordmark

Comparing the SEI's Views and Beyond Approach for Documenting Software Architectures with ANSI-IEEE 1471-2000

Technical Note
This report summarizes the V&B and 1471 approaches to architecture description, and shows how a software architecture document prepared using V&B can be made compliant with 1471.
Publisher

Software Engineering Institute

CMU/SEI Report Number
CMU/SEI-2005-TN-017
DOI (Digital Object Identifier)
10.1184/R1/6572672.v1

Abstract

Architecture documentation has emerged as an important architecture-related practice. In 2002, researchers at the Carnegie Mellon Software Engineering Institute completed Documenting Software Architectures: Views and Beyond (V&B), an approach that holds that documenting a software architecture is a matter of choosing a set of relevant views of the architecture, documenting each of those views, and then documenting information that applies to more than one view or to the set of views as a whole. Details of the approach include a method for choosing the most relevant views, standard templates for documenting views and the information beyond them, and definitions of the templates' content. At about the same time, the Institute of Electrical and Electronics Engineers (IEEE) was developing a recommended best practice for describing architectures for software-intensive systems—ANSI/IEEE Std. 1471-2000. Like V&B, that standard takes a multi-view approach to the task of architecture documentation, and it establishes a conceptual framework for architectural description and defines the content of an architectural description.

This technical note summarizes the two approaches and shows how a software architecture document prepared using the V&B approach can be made compliant with Std. 1471-2000.

Part of a Collection

Views and Beyond Collection

Cite This Technical Note

Clements, P. (2005, July 1). Comparing the SEI's Views and Beyond Approach for Documenting Software Architectures with ANSI-IEEE 1471-2000. (Technical Note CMU/SEI-2005-TN-017). Retrieved February 29, 2024, from https://doi.org/10.1184/R1/6572672.v1.

@techreport{clements_2005,
author={Clements, Paul},
title={Comparing the SEI's Views and Beyond Approach for Documenting Software Architectures with ANSI-IEEE 1471-2000},
month={Jul},
year={2005},
number={CMU/SEI-2005-TN-017},
howpublished={Carnegie Mellon University, Software Engineering Institute's Digital Library},
url={https://doi.org/10.1184/R1/6572672.v1},
note={Accessed: 2024-Feb-29}
}

Clements, Paul. "Comparing the SEI's Views and Beyond Approach for Documenting Software Architectures with ANSI-IEEE 1471-2000." (CMU/SEI-2005-TN-017). Carnegie Mellon University, Software Engineering Institute's Digital Library. Software Engineering Institute, July 1, 2005. https://doi.org/10.1184/R1/6572672.v1.

P. Clements, "Comparing the SEI's Views and Beyond Approach for Documenting Software Architectures with ANSI-IEEE 1471-2000," Carnegie Mellon University, Software Engineering Institute's Digital Library. Software Engineering Institute, Technical Note CMU/SEI-2005-TN-017, 1-Jul-2005 [Online]. Available: https://doi.org/10.1184/R1/6572672.v1. [Accessed: 29-Feb-2024].

Clements, Paul. "Comparing the SEI's Views and Beyond Approach for Documenting Software Architectures with ANSI-IEEE 1471-2000." (Technical Note CMU/SEI-2005-TN-017). Carnegie Mellon University, Software Engineering Institute's Digital Library, Software Engineering Institute, 1 Jul. 2005. https://doi.org/10.1184/R1/6572672.v1. Accessed 29 Feb. 2024.

Clements, Paul. Comparing the SEI's Views and Beyond Approach for Documenting Software Architectures with ANSI-IEEE 1471-2000. CMU/SEI-2005-TN-017. Software Engineering Institute. 2005. https://doi.org/10.1184/R1/6572672.v1