api-elements.js icon indicating copy to clipboard operation
api-elements.js copied to clipboard

Published 20 hours ago • verified publisher icon apiaryio

Translate root x- extensions into extension element

Open kylef opened this issue 6 years ago • 1 comments

We need to create a specification for this, we proposed in past to move it to apielements.org website.

kylef avatar Nov 13 '18 16:11 kylef

There is some design problems with the way that Swagger 2 adapter implements this which we should address in specification (https://help.apiary.io/profiles/api-elements/vendor-extensions/).

The open questions:

  • How should object be serialised? Swagger 2 adapter and extension spec incorrectly makes this into a object not object element.
  • How should we map extensions to elements? Some categories of extensions either overlap or do not map to API Elements. For example info and "root" extension.

kylef avatar Nov 27 '18 01:11 kylef