Here are some templates for representing the architecture. Architecture can be represented in a variety of ways,
according to the needs of the project team. See Architecture Notebook for more information.
Feel free to use one or more of these templates or create your own.
The Architect should decide what views are useful for describing the system under
Consider one or more relevant views of the architecture and document each one using the provided template for the
architectural view. If needed, document information that applies to more than one view using the template provided for
the Software Architecture Document to get an integrated representation of the architecture instead of just snapshots
taken from different angles.
The structuring of the documents must support the needs of the intended audience. For example, instead of a document
for the implementation view developers may find more useful alternative forms for the project directory structure like
the template provided for the project startup kit.
Keep documentation up-to-date but to an essential minimum. When the architecture is under development, decisions are
reconsidered frequently so constant revision of the documentation is an unnecessary expense. Determine points in
the development lifecycle when documentation should be updated.