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


Full Text : https://apps.dtic.mil/dtic/tr/fulltext/u2/a537057.pdf


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