New API Using the OpenAPI Specification

[kinlane]

This is a conversation thread for the "New API Using the OpenAPI Specification" blueprint. It is meant to help iterate and evolve this blueprint along with pull request changes. Here are the two relevant links for this blueprint:

• Detail Page
• YAML Source

Leave all questions, comments, and feedback here, and go ahead and submit pull requests against any pages you want to make a change to, adding or updating content.

[kinlane]

I feel like the design portion is lacking depth. It is like the how to draw an owl story, here is a circle, now draw an owl, but instead here is an OpenAPI, now design an API. Could we have a REST API design element that is dedicated to providing the building blocks of REST design?