docs: add note about Swagger UI simulator and CORS restrictions

Author: daniel-jones-dev

CHANGELOG.md

@@ -13,6 +13,7 @@ typos, schema fixes, or adding examples.
 ## [2.4.0]
 ### Added
 * Add formality options prefer_less and prefer_more.
+* Add note to readme about Swagger UI simulator and CORS restrictions.
 
 
 ## [2.3.1]

README.md

@@ -9,6 +9,9 @@ You can use this specification to explore the API in tools like
 using tools such as [Swagger Editor][swagger-editor] or
 [OpenAPI Generator][openapi-generator].
 
+Note that Swagger's "Try it out" in-browser simulator creates valid Curl
+requests, the requests will fail due to [CORS][cors-docs] restrictions.
+
 [Changelog](CHANGELOG.md)
 
 If you encounter issues while using this OpenAPI specification or have feature
@@ -24,4 +27,6 @@ requests, please [create an issue][issues].
 
 [postman]: https://www.postman.com/
 
-[swagger-editor]: https://editor.swagger.io/?url=https://raw.githubusercontent.com/DeepLcom/openapi/main/openapi.yaml
+[swagger-editor]: https://editor.swagger.io/?url=https://raw.githubusercontent.com/DeepLcom/openapi/main/openapi.yaml
+
+[cors-docs]: https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS