Congratulations, you finished the documenting REST APIs section of the course. You’ve learned the core of documenting REST APIs. We haven’t covered publishing tools or strategies. Instead, this part of the course has focused on the creating content, which should always be the first consideration.
During this part of the course, you learned the core tasks involved in documenting REST APIs. First, as a developer, you did the following:
Then you switched perspectives and approached APIs from a technical writer’s point of view. As a technical writer, you documented each of the main components of a REST API:
Although the technology landscape is broad, and there are many different technology platforms, languages, and code bases, most REST APIs have these same sections in common.
If you’d like to get more practice making requests to APIs and doing something with the response (even just printing it to the page), check out the additional tutorials in the Resources section:
Now that you’ve got the content down, the next step is to focus on publishing strategies for API documentation. This is the focus of the next part of the course.
39/91 pages complete. Only 52 more pages to go...
Get new posts delivered straight to your inbox.
© 2017, Tom Johnson