Add an intro and other missing sections

OAI / Overlay-Specification

The OAI Overlay Specification

Apache License 2.0

57 stars 15 forks source link

Add an intro and other missing sections #47

Closed lornajane closed 2 months ago

lornajane commented 2 months ago

We had some "TBD" sections, I removed one (data types, I don't think we can add this after so many people have implemented, and Overlays could span multiple OpenAPI versions!?!?), wrote an intro, and used a version of the Arazzo wording, acknowledging the retroactive nature of the 1.0.0 version specifically.

Hopefully this fills the main gaps! Fixes #44

kevinswiber commented 2 months ago

Thank you for doing this, @lornajane!