docs(API): Mention upload limits on upload endpoint docs

Author: jablan

doc/compiled.json

@@ -1812,6 +1812,7 @@
                 "type": "integer"
               },
               "translation_keys_unmentioned": {
+                "description": "The number of translation keys in the project that were not mentioned in the upload.\n\nNote: this field is not calculated (and shows 0) if the upload contains more than 10,000 keys.\n",
                 "type": "integer"
               },
               "translations_created": {
@@ -14669,7 +14670,7 @@
     "/projects/{project_id}/uploads": {
       "post": {
         "summary": "Upload a new file",
-        "description": "Upload a new language file. Creates necessary resources in your project.",
+        "description": "Upload a new language file. Creates necessary resources in your project.\n\nNote: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0).\n",
         "operationId": "upload/create",
         "tags": [
           "Uploads"

paths/uploads/create.yaml

@@ -1,5 +1,8 @@
 summary: Upload a new file
-description: Upload a new language file. Creates necessary resources in your project.
+description: |
+  Upload a new language file. Creates necessary resources in your project.
+
+  Note: be aware of [upload limits](https://support.phrase.com/hc/en-us/articles/8548271212188-Phrase-Strings-Limits#file-size-upload-limits-0-0).
 operationId: upload/create
 tags:
   - Uploads

schemas/upload.yaml

@@ -35,6 +35,10 @@ upload:
         translation_keys_updated:
           type: integer
         translation_keys_unmentioned:
+          description: |
+            The number of translation keys in the project that were not mentioned in the upload.
+
+            Note: this field is not calculated (and shows 0) if the upload contains more than 10,000 keys.
           type: integer
         translations_created:
           type: integer