6. Beyond the Basics

image

This chapter contains guidelines for dealing with several aspects of documentation that either span views or are not specific to any particular category of views:

6.1 Refinement. Refinement is a way to reveal more information over time as it becomes available. Refinement reflects how architectures develop over time, and it lets architects present information in more or less detail to serve various audiences. This section discusses two kinds: decomposition refinement and implementation refinement.

6.2 Descriptive completeness. Does your architecture document tell the truth, the whole truth, and nothing but the truth? There ...

Get Documenting Software Architectures: Views and Beyond, Second Edition now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.