Chapter 6. Service-Related Documentation

Objectives

In an enterprise that is pursuing a service-oriented architecture, the consumers and providers of services tend to be different groups, often in different organizations. In this situation the quality, availability, and accessibility of service-related documentation has a significant impact on the usage levels of services and on the level of effort required for use. This chapter explores the nature of the documentation required to support service usage.

There are a number of types of documents necessary to support the efficient use of services, including

• A one-line service description

• A brief abstract of the service

• A service specification

• A service utilization contract for each type ...

Get Architecting Composite Applications and Services with TIBCO® 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.