Merge pull request #213 from baywet/feat/comments-appendix

feat: adds information about overlay and comments in descriptions

Author: baywet

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 |