Documenting Software Architectures: Views and Beyond, Second Edition

Part III. Building the Architecture Documentation

Parts I and II covered the kind of information that should appear in architecture documentation. Part I covered styles, with their attendant element and relation types, that architects can use to engineer views. Part II covered other critical information beyond elements and relations that should be documented.

Part III deals more directly with the care and feeding of the architecture documentation itself. Exactly how does an architect decide what views to put into an architecture document? How should the architecture document be organized, laid out, divided into sections, and packaged? How should it be reviewed for quality and fitness for stakeholder use?

These and other topics are the subject ...