Documenting Software Architectures: Views and Beyond, Second Edition

Part II. Beyond Structure: Completing the Documentation

Part I presented a substantial repertoire of useful architecture styles. An architect can choose from among these styles, pick styles in other style catalogs, or design a new style. Once a style is chosen, the view based on it needs to be designed and documented. The chapters in Part I presented ways to document the elements and relations that populate a view.

But documenting a view involves more than just writing down (or more often, drawing) the elements and their relations. Elements have interfaces, and those need to be documented so that teams developing other elements can interact with them correctly. Elements have behavior, and confederations of elements have collective behavior, ...