Use new OpenAPI spec?

[dten]

Just reading through this but looks like they finally got round to it

https://medium.com/slack-developer-blog/standard-practice-slack-web-openapi-spec-daaad18c7f8

[saethlin]

It looks to me like this only documents the HTTP API, not the types that come from the RTM API. It looks encouraging, but I want to make sure I'm not missing out on something; if my assessment is correct we'll still need manual maintenance of some components.

[Mange]

I raised a question for the official Swagger docs repo from Slack here slackapi/slack-api-specs#7

[rbtcollins]

They have it but they aren't keep it up to date - at the time of this comment, it is 9 months since the last update to it, and apps.connections.open (as a specific API I went looking for) is missing from it.