WIP Generated OpenAPI specification

[gr2m]

This is a work-in-progress implementation for part two of #168: "Generate OpenAPI specification"

• I removed all operations but "Get a single issue"
• I inlined all parameters and response schemas
• Information like path parameter description got lost because we don’t have these. We’d need to maintain a list ourselves.

The response schemas are also much simpler. I will wait to see if @kytrinyx can provide schemas that GitHub is using internally for their REST APIs.

Test with

node bin/octokit-rest-routes.js update https://developer.github.com/v3/issues/#{get-a-single-issue,list-issues,create-an-issue,edit-an-issue,lock-an-issue,unlock-an-issue} --cached

Todos

• deprecations. "Get single issue" has now an :issue_number, previously :number (See OpenAPI: figure out deprecations #418)

[todo]

find a better place to define parameter examples

routes/lib/check-or-update-routes.js

Lines 21 to 26 in 4803037

	// TODO: find a better place to define parameter examples
	const PARAMETER_EXAMPLES = {
	owner: 'octocat',
	repo: 'hello-world',
	number: 1
	}

---

This comment was generated by todo based on a TODO: comment in 4803037 in #328. cc @octokit.