Skip to content

Latest commit

 

History

History
31 lines (21 loc) · 1.24 KB

CONTRIBUTING.md

File metadata and controls

31 lines (21 loc) · 1.24 KB

Contributing to open-api

Thank you! This project was started with one goal in mind: to provide 1st class support for openapi in the node ecosystem. It's usage is constantly growing. With growing usage comes more scrutiny and opportunities to improve. If you've come here with an issue: know that the maintainer[s] care deeply ❤️

Status of OpenAPI V3

Note: this section was written on 2018-10-04 and may be out of date

When this project began:

  • OpenAPI had just formed.
  • Swagger 2.0 was the sole version.
  • OpenAPI V3 was just a dream on the horizon.

Since then we've seen the publishing of the V3 schema in a README, but not yet in a JSON Schema file. See OAI/OpenAPI-Specification#1032.

If you're expecting to have fast resolution of issues relating to V3 then you'll have to open a Pull Request. The reason for this is that the schema is still in flux and the Maintainer[s] must focus their time on reviewing and publishing code.

Status of OpenAPI V2

V2 (fka swagger 2.0) is fully supported and extensively tested.

The Maintainer's Pledge

To respond swiftly, to deal justly...