-
Strong contract needed for Java API's to succeed as Web services (0 messages)
- Posted by: Rush Kester
- Posted on: April 05 2016 14:06 EDT
In order for a collection of API's to be successfully used by others, there needs to be good documentation of what services each API provides, and especially inputs/outputs and state data maintained. In addition a taxonomy needs to be agreed to for use in API catalogs so developers can quickly find the API's they need (using a variety of terms to describe the capability they are seeking).Is there guidance for API documentation and feature taxonomy?