Documenting Software Architectures: Views and Beyond, Second Edition

Preface

The purpose of this book is to answer the following question:

How do you document an architecture so that others can successfully use it, maintain it, and build a system from it?

The audience for this book includes all the people involved in the production and consumption of architecture documentation. The goal of this book is to help you decide what information about an architecture is important to capture and to provide guidelines, notations, and examples for capturing it. We intend this book to be a practitioner-oriented guide to the various kinds of information that constitute an architecture. We give practical guidance for choosing what information should be documented and show—with examples in various notations, including but not ...