diff --git a/versions/1.1.0-dev.md b/versions/1.1.0-dev.md index 96fab9b..d6f8a6d 100644 --- a/versions/1.1.0-dev.md +++ b/versions/1.1.0-dev.md @@ -282,6 +282,10 @@ The extensions may or may not be supported by the available tooling, but those m Overlay files MAY choose to follow the convention of a `purpose.overlay.yaml` file naming pattern. Other file naming conventions are also supported. +### Comments in OpenAPI descriptions + +Some formats, like [YAML](https://yaml.org/) or [JSONC](https://jsonc.org/), support using comments which do not impact the semantic meaning of the description. Applying Overlay Actions to a description MAY result in the loss of such comments in the updated description. The exact behavior is specific to the tool implementing the Overlay Specification. + ## Appendix A: Revision History | Version | Date | Notes |