Support for OpenAPI v2? about create-openapi-repo

[adamaltman]

Yes, only in the history of this repository.

d4343f1

The repository structure is for writing API definitions by hand. I really recommend you utilize the latest version of the spec to do that. OAS3 has been out for almost 3 years already.

[gchan]

Thanks for the info @adamaltman

We use the latest Ruby library Grape-Swagger however that currently only produced OAS2 :(

I'm currently looking at OAS2 to OAS3 converters so we can use the latest version of create-openapi-repo. Do you think that would be feasible? Would there be any compatibility issues between the two specs (I'm getting up to speed at the moment!)?

Ideally we would like to build an automated pipeline which publishes the latest documentation to Github pages :)

[adamaltman]

I don't think you need this repository if you're using code annotations. The purpose of this repo is for those who hand-author their API definitions.

Check out https://github.com/redocly/redoc to build the docs from your annotation-generated API definitions.

[gchan]

Thanks for the tip!

One of the 'nice to haves' is the ability to add supplementary documentation in Markdown. It seems this repo has some interesting tools to build/bundle multiple files into a single file. I'll take a look at https://github.com/redocly/redoc