Add support for importing non yaml files as block's

[jdarling]

Currently there is no (easy) way to define an external file that is not a yaml file. It would be nice to have something like the ability to include an arbitrary file as a text block into a definition. For example you could extract the descriptions into their own .md file, or code samples into their own . files for inclusion.

This could be done as either an extension of $ref's ability to include files or as a new directive.

[darrelmiller]

Autorest has an interesting alternative way of blending markdown and OpenAPI descriptions. https://github.com/Azure/autorest/blob/master/Samples/3a-literate-swagger/swagger.md

For examples you can use externalValue to point to any kind of document.

[michael-o]

Autorest has an interesting alternative way of blending markdown and OpenAPI descriptions. https://github.com/Azure/autorest/blob/master/Samples/3a-literate-swagger/swagger.md

For examples you can use externalValue to point to any kind of document.

This link is dead now.

[MikeRalphson]

Thanks. The reference file appears to have been moved to https://github.com/Azure/autorest/blob/master/Samples/openapi-v2/3a-literate-swagger/swagger.md

[handrews]

Does the External Documentation Object solve this problem?

[github-actions]

This issue has been labeled with No recent activity because there has been no recent activity. It will be closed if no further activity occurs within 28 days. Please re-open this issue or open a new one after this delay if you need to.