Frequently when tech writers start creating API documentation, a developer will ask, Why don't we use Swagger? Swagger, or the OpenAPI specification, is an open standard for describing your REST API. The Swagger/OpenAPI spec, which is created in YAML or JSON, can be parsed by different tools, such as the Swagger UI framework. Swagger UI can create an interactive experience for users to try out your API calls using their own API keys. This can be a powerful addition to your API documentation, since it gives users a sandbox to experiment with your API in an immediate way.
Visiting Dojo Expert
Tom Johnson, I'd Rather Be Writing. Web-savvy technical writer with strong knowledge of APIs, passionate about creating documentation that pushes traditional boundaries to improve the user experience. Enjoy working in agile developer environments, knee-deep in code, double-checking instructions to make sure they're as accurate, clear, and complete as possible. Artful with visual communication, especially creating diagrams, illustrations, and video tutorials.
Watch the Video
Recorded: January 2017
You might also be interested in...
Templates for API Documentation
Clarence Cromwell
Basic Git Tracking for Day-to-Day Work
Karl Klashinsky
From Open Source Volunteer to Full-Time Tech Writer
Gale Naylor, Facebook
Key Concepts:
Filed under:
About the TC Dojo
At the TC Dojo, you pick the topics and we find the experts. Join our mailing list so you can attend the next one live. After all, you can't ask questions of a video.