OpenAPI.NET Overlay support spec doc

add a folder for specs and add the first spec doc for overlay support.

Mar 18 '24 18:03 njaci1

We should add some discussion of the developer experience of applying an overlay. Is this a separate OverlayService class? Is it an extension method on OpenAPIDocument? Does it change the existing document or create a new patched document? Is it in a different project? If not, how do we handle the YAML dependency?

Mar 19 '24 13:03 darrelmiller

Maybe use this issue to add onto some of the use cases or scenarios where overlays would come in handy https://github.com/microsoft/OpenAPI.NET/issues/615

Mar 20 '24 14:03 MaggieKimani1

We should add some discussion of the developer experience of applying an overlay. Is this a separate OverlayService class? Is it an extension method on OpenAPIDocument? Does it change the existing document or create a new patched document? Is it in a different project? If not, how do we handle the YAML dependency?

@darrelmiller I have added a section on 'User Journey' to start the discussion. Have a look at it and continue the discussion.

Mar 27 '24 14:03 njaci1

sorry about the closure, we have aligned branching with other repositories, if this is still relevant, please re-open on main

Feb 06 '25 14:02 baywet