matthewtrask/openapi-talk.md

Created February 26, 2020 15:37

Star (0) You must be signed in to star a gist
Fork (0) You must be signed in to fork a gist

Learn more about clone URLs
Clone this repository at <script src="https://gist.github.com/matthewtrask/9ad891bed4e9d26fd8d6e404be490998.js"></script>
Save matthewtrask/9ad891bed4e9d26fd8d6e404be490998 to your computer and use it in GitHub Desktop.

Raw

It's been over 5 years since Swagger was handed over and turned into the OpenAPI Specification. However, people still get stuck on how to get started with building an API using the specification. This talk covers what OpenAPI does, how to get your team leads, managers, and above to buy into using the specifcation, how to start with it, and breaking down the core concepts of the specification and with some time left over we will look at some deeper topics like the $ref key and how you can maintain large spec files with ease.

chrisspruck commented Feb 28, 2020

and breaking down the core concepts of the specification and with some time left over we will look at some deeper topics

In case you want to use this elsewhere, when I posted to AtlantaPHP, I tweaked the above slightly, so it reads a bit more smoothly.

and breaks down the core concepts of the specification. If time permits, we will look at some deeper topics