I’m planning to use jsonapi conventions for a REST API designed and documented with swagger. Although I could inline the jsonapi definitions there (e.g., for error, meta, etc), it would seem better to reference them in an external doc.
First, does that sound right?
Second, has anyone done this? If so, any tips? Do I need a yaml version of the schema, or will http://jsonapi.org/schema work as-is?