Have you guys done any work on hypermedia APIs? Specifically I'm implementing an API that uses HAL (json+hal) with features such as links to other resources and 'profile' properties. These hypermedia formats potentially open up a way to automate some pretty sophisticated documentation capabilities. I'm not sure how this factors into what kinds of capabilities you could support in the future and it's probably not widely used yet but it's something to think about going forward. There are other competing formats like collection+json, jsonapi.org, to consider as well.
The “Resource Blueprint” https://github.com/apiaryio/api-blueprint/tree/resource-blueprint concept has been introduced.
While there is no implementation of it yet, we plan to move into that direction.
AdminLukas Linhart (Admin, apiary.io) commented
before diving in: what specific features you think would help you?
How could Apiary help you with hypermedia/HATEOAS?