copilot suggestions

Author: jablan

doc/compiled.json

@@ -8833,21 +8833,22 @@
             }
           },
           {
-            "description": "If a key has no translation in the locale being downloaded the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires include_empty_translations to be set to `true`.",
-            "example": null,
             "name": "fallback_locale_id",
+            "description": "If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used.\nProvide the ID of the locale that should be used as the fallback.\nRequires `include_empty_translations` to be set to `true`. Mutually exclusive with `use_locale_fallback`.\n",
             "in": "query",
             "schema": {
               "type": "string"
-            }
+            },
+            "example": null
           },
           {
-            "description": "If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used.\nFallback locale is defined in [locale's settings](/en/api/strings/locales/update-a-locale#body-fallback-locale-id).\nRequires `include_empty_translations` to be set to `true`.\n",
             "name": "use_locale_fallback",
+            "description": "If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used.\nFallback locale is defined in [locale's settings](/en/api/strings/locales/update-a-locale#body-fallback-locale-id).\nRequires `include_empty_translations` to be set to `true`. Mutually exclusive with `fallback_locale_id`.\n",
             "in": "query",
             "schema": {
               "type": "boolean"
-            }
+            },
+            "example": true
           },
           {
             "description": "Provides the source language of a corresponding job as the source language of the generated locale file. This parameter will be ignored unless used in combination with a `tag` parameter indicating a specific job.",
@@ -9061,12 +9062,12 @@
                     ]
                   },
                   "fallback_locale_id": {
-                    "description": "If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used.\nProvide the ID of the locale that should be used as the fallback.\nRequires `include_empty_translations` to be set to `true`.\n",
+                    "description": "If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used.\nProvide the ID of the locale that should be used as the fallback.\nRequires `include_empty_translations` to be set to `true`. Mutually exclusive with `use_locale_fallback`.\n",
                     "type": "string",
                     "example": "abcd1234abcd1234abcd1234abcd1234"
                   },
                   "use_locale_fallback": {
-                    "description": "If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used.\nFallback locale is defined in [locale's settings](/en/api/strings/locales/update-a-locale#body-fallback-locale-id).\nRequires `include_empty_translations` to be set to `true`.\n",
+                    "description": "If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used.\nFallback locale is defined in [locale's settings](/en/api/strings/locales/update-a-locale#body-fallback-locale-id).\nRequires `include_empty_translations` to be set to `true`. Mutually exclusive with `fallback_locale_id`.\n",
                     "type": "boolean",
                     "example": false
                   },

paths/locale_downloads/create.yaml

@@ -76,14 +76,14 @@ requestBody:
             description: |
               If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used.
               Provide the ID of the locale that should be used as the fallback.
-              Requires `include_empty_translations` to be set to `true`.
+              Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `use_locale_fallback`.
             type: string
             example: abcd1234abcd1234abcd1234abcd1234
           use_locale_fallback:
             description: |
               If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used.
               Fallback locale is defined in [locale's settings](/en/api/strings/locales/update-a-locale#body-fallback-locale-id).
-              Requires `include_empty_translations` to be set to `true`.
+              Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `fallback_locale_id`.
             type: boolean
             example: false
           source_locale_id:

paths/locales/download.yaml

@@ -100,20 +100,24 @@ parameters:
     in: query
     schema:
       type: boolean
-  - description: If a key has no translation in the locale being downloaded the translation in the fallback locale will be used. Provide the ID of the locale that should be used as the fallback. Requires include_empty_translations to be set to `true`.
-    example:
-    name: fallback_locale_id
+  - name: fallback_locale_id
+    description: |
+      If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used.
+      Provide the ID of the locale that should be used as the fallback.
+      Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `use_locale_fallback`.
     in: query
     schema:
       type: string
-  - description: |
+    example:
+  - name: use_locale_fallback
+    description: |
       If a key has no translation in the locale being downloaded, the translation in the fallback locale will be used.
       Fallback locale is defined in [locale's settings](/en/api/strings/locales/update-a-locale#body-fallback-locale-id).
-      Requires `include_empty_translations` to be set to `true`.
-    name: use_locale_fallback
+      Requires `include_empty_translations` to be set to `true`. Mutually exclusive with `fallback_locale_id`.
     in: query
     schema:
       type: boolean
+    example: true
   - description: Provides the source language of a corresponding job as the source language of the generated locale file. This parameter will be ignored unless used in combination with a `tag` parameter indicating a specific job.
     example:
     name: source_locale_id