[FEATURE REQUEST] RAML-like overlays

[fmvilas]

Is your feature request related to a problem? Please describe.
I want to be able to add and/or override parts of the content of an AsyncAPI document, for instance, being able to provide the same documentation in different languages.

Can't it be tackled using specification extensions?
No.

Describe the solution you'd like
Don't have a solution yet. Will make a proposal soon.

Describe alternatives you've considered
Using specification extensions, but it's overly complicated.

[MikeRalphson]

See also OAI/Overlay-Specification#36

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[mattbishop]

OpenAPI has an overlay spec they are working on here: https://github.com/OAI/OpenAPI-Specification/blob/master/proposals/004_Overlays.md

[fmvilas]

Thanks, Matt. @darrelmiller, is it going to finally make it to 3.1.0?

[smoya]

Is this something we want to still go for? Shall we keep this issue open or can be close it @fmvilas ?

[fmvilas]

I think that's already in v3, right? We changed the merging algorithm.

[smoya]

I think that's already in v3, right? We changed the merging algorithm.

Then I didn't understand the meaning of this issue 😅 . Closing it then.