Suggestions for Documenting SOA-Based Systems

This paper provides suggestions for documenting service-oriented architecture-based systems based on the Views & Beyond (V&B) software documentation approach. The V&B documentation approach is a lightweight and flexible approach to documenting software architecture developed by Carnegie Mellon University's Software Engineering Institute. This paper also includes an overview of several well-known Service-Oriented Architecture (SOA) documentation challenges and suggestions for tailoring and augmenting the V&B approach to address those challenges.