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 ...