Since octokit/routes is archived, should this use the OpenAPI Description instead?

[francisfuzz]

👋 @swinton!

I recently imported this and noticed there were some missing routes. Reading up on https://github.com/octokit/routes, it's deprecated (latest: v30.0.3) in favor of the OpenAPI Description:

https://github.com/github/rest-api-description/

I'm wondering if this repo should use that instead? Not quite sure how much work it would take to port over, but thought to raise this so others who rely on this are aware!

[francisfuzz]

Update: I discovered that OpenAPI is supported by Insomnia (docs) and it's possible to import it directly. For example, the OpenAPI Description for api.github.com is available, and Insomnia will do the Right Thing:tm: by importing its raw version.

At this point, I'm wondering if we should just point folks to this method instead? 💭

[swinton]

@imjohnbo started to PR this: #72

We felt this project was still helpful, since it also generates environment variables.