Forum Discussion

serefarikan's avatar
serefarikan
New Contributor
4 years ago

Confused by multiple documentations for OpenAPI

Hi,

I found the following page while trying to understand how inheritance is handled in openAPI:

 

This page: Inheritance and Polymorphism (swagger.io) has the label/warning that says: This guide is for OpenAPI 3.0.

 

There is also another page that is also the specification: https://swagger.io/specification but the overall style and flow of these two pages are significantly different. For example, the first one contains a section titled "What is OpenAPI". The second one reads more like a reference.

 

Why are there two urls for the specification? Is the second one supposed to replace the first?  Do they overlap? Some guidance from the community would help me navigate content more efficiently 🙂