Accession Number : ADA537057
Title : Suggestions for Documenting SOA-Based Systems
Descriptive Note : Final technical rept.
Corporate Author : CARNEGIE-MELLON UNIV PITTSBURGH PA SOFTWARE ENGINEERING INST
Personal Author(s) : Bellomo, Stephany
Report Date : Sep 2010
Pagination or Media Count : 42
Abstract : This report 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 report 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. The author hopes that the suggestions presented in this report will help SOA developers to avoid some of the common documentation pitfalls and produce higher quality SOA documentation.
Descriptors : *COMPUTER PROGRAM DOCUMENTATION , *SOFTWARE ENGINEERING , *COMPUTER ARCHITECTURE , QUALITY
Subject Categories : Computer Programming and Software
Distribution Statement : APPROVED FOR PUBLIC RELEASE