Unit Testing Your Docs
API docs have code snippets in them to help users get through simple and complex problems. Those code snippets are the ones most likely to be broken. In this talk, you’ll learn how to ensure that none of the code in your docs will be out of date & how you can make it part of your deploy cycle.
When you’re focused on getting a bug release shipped, one of the last things you’re thinking about is updating the docs. So the docs get shipped and become out of date with the current version of your API. That’s when users start getting confused and it could take weeks to figure out it’s because they are copying an old example from your documentation.
By including unit tests for all of the code snippets you use, you’re setting yourself up for long-term success with documentation maintenance. It’s no different than writing tests for the APIs and it will save you a lot of time trying to handle user questions. By the time attendees leave this talk, they will know how to implement unit testing into their new or existing docs and how they can deploy them.