Chapter 2. Diagramming Software Fortresses

Up to now I have been using an informal documentation style consisting primarily of cartoon characters. These work for high-level presentations of the PowerPoint variety, but as we move into serious discussions at the architect level, we need something a little more formal. In this chapter I'll present the main documentation techniques I have found helpful in describing software fortress architectures.

My philosophy in choosing documentation techniques has been to borrow wherever possible from existing techniques, especially UML, adapting them as little as possible to make them work for software fortresses.

Get Software Fortresses: Modeling Enterprise Architectures now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.