Overview

This book has presented guidance for assembling a package of effective, usable architecture documentation. We have offered a selection of viewtypes and styles that should fulfill the needs of most software architects and architectures and have shown how to document a wide range of architecture-centric information: from behavior to interfaces to rationale. The book stands on its own as a complete handbook for documentation.

But the book does not exist in a vacuum. Other writers, on their own or under the auspices of large organizations, have prescribed specific viewsets or other approaches for architecture. The IEEE has a standard for architecture documentation. Many people are writing about how to document an "enterprise architecture." It may not be clear whether the advice in this book is in concert or in conflict with these other sources. In some cases, it isn't clear whether there's a relationship at all.

Suppose, for example, that you're mandated to follow the precepts of the Rational Unified Process, with its five-view prescription. Or suppose that you think that the Siemens Four Views approach is the way to go. Or perhaps you work for a part of the U.S. government, which mandates adherence to the C4ISR architectural framework. Or you want to make sure that your products are compliant with ANSI /IEEE-1471-2000, the recent standard on architecture documentation. Or it's your lot to write down your organization's enterprise architecture. Can you use the prescriptions in this book and still meet your goals?

This chapter takes a tour of some significant related work in the field, with an eye toward reconciling our advice with their advice. We cover

• Rational Unified Process/Kruchten 4+1
• UML
• Siemens Four Views
• C4ISR architecture framework
• ANSI/IEEE-1471-2000 for architecture documentation
• Data flow and control flow views
• RM-ODP

Additionally, some topics are related to documentation but are not part of it. We discuss a few of these in Section 11.9, where we consider

• Architecture description languages
• Commercial components
• Hypertext documentation
• Configuration management