Having an OpenAPI Specification (OAS) is a useful document for numerous reasons. The most common being the ease of generating API reference documentation, but it overshadows some additional benefits that you can gain from adopting the OpenAPI Specification. This talk will delve into the hidden value of the OpenAPI Specification, and how you can employ it to your advantage. Some of the ideas that we will explore are:

- What are the lesser known benefits of using OAS to build API docs
- What is a single source of truth in an API
- How OAS gives us a way to breakdown APIs and helps us improve communication around HTTP
- How design-first APIs, mocking, and testing with OAS can create better developer experiences through feedback cycles
- How OAS creates a structured document for collaboration between teams and other ways OAS can increase collaboration throughout the API design process

Attendees will leave the talk having a better grasp of how the OpenAPI Specifications can fit into their workflow, including different PHP and language-neutral tools, and how they can leverage it to improve their API design and developer experience processes.


Comments are closed.

TJ Draper at 11:57 on 3 May 2019

Nice overview of OpenAPI tooling and how to go about implementing.

Darren Wright at 12:01 on 3 May 2019

Great talk, info, and creative slides.

Matt Griffith at 12:06 on 3 May 2019

Very good talk with amazing slides.

Chris Holland at 12:48 on 3 May 2019

Really great talk, I loved the slides look and feel, and the delivery was very engaging as well. Overall very informative as well.

Adam Kelso at 12:56 on 3 May 2019

Very good talk about OAS. Very easy to follow and engaging presentation style. Only additional thing would be a little more walk through of the different parts of the spec, but I understand this was a talk more about the benefits of using it.

Loved the slides! Inspired to go and review the tools and URLs provided and start using this stuff now.

derak.kilgo at 15:34 on 3 May 2019

Good intro to OpenAPI and what it can do for an api driven org.

Roger Creasy at 19:56 on 3 May 2019

Taylor knows the topic and explains things well. I really like the hand-drawn slides; they add a lot of personality to the presentation.

Omni Adams at 13:51 on 4 May 2019

Awesome slides, great information. I especially liked the discussion about some of the other tools that OpenAPI opens up access to.

Honestly, the only bad thing about the talk is that it was scheduled in a 30-minute slot instead of the hour it deserved.