Documentation is the first touch point for those curious about new software. This is especially true for APIs, because clear documentation makes it easy to understand and use them – it is often the make-or-break point for new users. As an increasing number of people read and use the documentation for the cognitive services that we deliver in the Watson Developer Cloud (WDC), the WDC documentation team receives plenty of feedback – some positive, some negative, but all useful. We want to learn from that feedback, and improve both the documentation and the experience of using it. Sounds something like the WDC services themselves, doesn’t it? Hey, people were cognitive first! At any rate, we continuously expand and revise the documentation for the WDC services to deliver the right information, in the right way, to a variety of different audiences. To help address the immediate needs of our developer audience, we’ve rolled out documentation updates across the WDC doc set, the most visible of which are the following:
- Documentation for each service is no longer located on a single page. It has been divided into multiple files in order to unclutter the navigation for each service. This makes it easier for users to locate specific information with minimal scrolling.
- Documentation for each service now begins with quick-start sections that explain how to get a sample application up and running on your system or in the Bluemix environment.