I was looking for a tool to document our API so that I could share it with external vendors. Then I came across OpenAPI and I was up until 4 AM soaking in everything related to it. I don't know why more people are not talking about it. Apart from the documentation, the multi-platform binding/stub generation tool make it very attractive for fully in-house projects as well.