Question about including extensions

[blarghmatey]

What is the proper method for signifying inclusion of an extension in this repository within an API? Should the full URL to the extension markdown file be added as a profile link relation? In particular I am interested in taking advantage of the value-types extension and am wondering how best to signify that fact to third party clients of my API.

Thank you for your time.

[mamund]

@blarghmatey :

sorry for the delayed response

you can add link elements at the top of the document using the "ext" link relation value to indicate which extensions appear in the body:
https://gist.github.com/mamund/655c6c8d6a28939f5a444ed01640049e

keep in mind that this MUST not create a REQUIREMENT for the parser, IOW, all extensions MUST be backward-compatible. existing parsers/clients/etc MUST NOT reject a representation just because it has an extension assertion at the top.

hope this helps.