PRESENTATION: Describe Your API With OpenAPI
Presentation by Ben Ramsey, Software Architect, ShootProof
No matter how big or small your API, no matter the audience, internal or external, you need to provide clear and precise documentation so that others know how to use it. Since its inception as Swagger almost ten years ago, OpenAPI has been steadily gaining ground as the de facto specification for describing REST APIs. Whether your API is yet to be built or has been around for a decade, OpenAPI is a tool you can use to document all the parts of your APIs.
In this talk, I'll introduce you to the basic concepts of OpenAPI, we'll use it to create documentation for a simple API, and I'll leave you with a few tips, tricks, and gotchas I've learned along the way. You should be able to take what you've learned and immediately begin describing your APIs with OpenAPI.
About Ben: Ben Ramsey is a web developer, author, and speaker. He is a software architect at ShootProof, where he builds a platform for professional photographers. He enjoys working on APIs, developing open source software, playing table-top games, and spending time with his family. Ben blogs at https://benramsey.com and is @ramsey (https://twitter.com/ramsey) on Twitter.
New Meeting Feature: Open Spaces! We're going to continue with a new discussion format among attendees. Please come with some questions or discussion topics in mind. The group will vote on suggestions and we'll cover things, based on interest, in a rotating panel style. Come share your expertise!
Map Link: https://goo.gl/maps/N2F52DZs9Cs (parking deck entrance, 600 building is due north of the deck)
SPECIAL NOTE: There will be a Braves game on this night, so there will be people monitoring the parking deck entrances. You will need to say you are coming to a meeting at ShootProof to be allowed to park (and also mention it to building security, as always.) It is best to arrive no later than 7pm.
Food provided by AtlantaPHP.