Announcement:I'm giving an API documentation workshop in Mountain View, California on August 30, 2019. If you're interested, you can register on EventBrite.
Slides for Documenting REST APIs Workshop — 2016 STC Summit Anaheim, Calif.
Here are the slides:
You can find more detail in my API doc course. (These slides are slightly updated from some of the topics in my course, but generally the slide number in the heading title corresponds with the course number.)