Rename openapi_simplified.yaml to openapi_gitbook.yaml and add short explanation

Author: daniel-jones-dev

README.md

@@ -3,7 +3,7 @@
 This project contains an [OpenAPI specification][openapi-specification] of the
 [DeepL API][deepl-api], in [YAML](openapi.yaml) and [JSON](openapi.json)
 formats.
-There is also a [simplified YAML](openapi_simplified.yaml) with reduced descriptions that is embedded in our [API documentation][deepl-api-docs].  
+There is also a [simplified YAML](openapi_gitbook.yaml) with reduced descriptions that is embedded in our [API documentation][deepl-api-docs].  
 
 You can use this specification to explore the API in tools like
 [Postman][postman], or to auto-generate documentation, SDKs, and code libraries

openapi_simplified.yaml openapi_gitbook.yamlopenapi_simplified.yaml renamed to openapi_gitbook.yaml

@@ -1,8 +1,10 @@
 openapi: 3.0.3
 info:
   title: DeepL API Documentation
-  description: The DeepL API provides programmatic access to DeepL’s machine translation
-    technology.
+  description: |-
+    The DeepL API provides programmatic access to DeepL’s machine translation technology.
+    
+    Note: this OpenAPI spec is embedded into our API documentation and has shortened descriptions.
   termsOfService: https://www.deepl.com/pro-license/
   contact:
     name: DeepL - Contact us