Merge branch 'dvc-1667-docs-es-variants' into 'main'

docs(voice): [DVC-1667] add es-419 (LATAM) to Voice API enums, matrix, changelog

Closes DVC-1667

See merge request deepl-org/deepl/clapi-track/api-docs-mirror!255

Author: hmls-uk

api-reference/openapi.json

@@ -10150,6 +10150,7 @@
             "en-GB",
             "en-US",
             "es",
+            "es-419",
             "et",
             "fi",
             "fr",
@@ -10216,6 +10217,7 @@
             "en-GB",
             "en-US",
             "es",
+            "es-419",
             "fi",
             "fr",
             "fr-CA",

api-reference/openapi.yaml

@@ -7652,6 +7652,7 @@ components:
           - en-GB
           - en-US
           - es
+          - es-419
           - et
           - fi
           - fr
@@ -7720,6 +7721,7 @@ components:
           - en-GB
           - en-US
           - es
+          - es-419
           - fi
           - fr
           - fr-CA

api-reference/voice/deepl-voice-api-service-specification-updates.mdx

@@ -100,6 +100,7 @@ audio provides the following functionality:
                 <li>`en-GB` (English (British))</li>
                 <li>`en-US` (English (American))</li>
                 <li>`es` (Spanish)</li>
+                <li>`es-419` (Spanish (Latin American))</li>
                 <li>`et` (Estonian)</li>
                 <li>`fi` (Finnish)</li>
                 <li>`fr` (French)</li>

docs/resources/roadmap-and-release-notes.mdx

@@ -13,6 +13,11 @@ rss: true
 - [`POST /v2/document`](/api-reference/document/upload-and-translate-a-document) protects brace-delimited placeholders in `json` documents by default: values such as `{stars}` or `{{userName}}` are kept verbatim instead of being translated along with the surrounding text. Set `input_conversion_options=version:1,json-placeholders:translate` to translate them instead.
 - ICU MessageFormat skeletons such as `{count, plural, one {# item} other {# items}}` are always protected, with only the branch text translated, in both modes.
 
+## September 30 - Voice API Spanish (Latin America)
+- The [Voice API](/docs/voice/overview) now supports `es-419` (Spanish, Latin America) as a target-language variant for translation and translated speech, in beta. Translation is provided by DeepL; translated speech is provided by an external service partner.
+- `es-419` translated speech is reported with `"external": true` and beta status in the [`GET /v3/languages?resource=voice`](/docs/languages/using-the-languages-api) response, so call with `include=beta&include=external` to see it.
+- See the [supported languages table](/docs/voice/supported-voice-languages) for the full Voice API language list.
+
 ## September 29 - New Document Formats (Beta) and Embedded Image Translation Controls
 - [`POST /v2/document`](/api-reference/document/upload-and-translate-a-document) now supports ten additional file formats, all currently in beta: `xlsm` (macro-enabled Excel), `zip` (SCORM e-learning packages), `vtt` (WebVTT subtitles), `yaml` / `yml`, `properties` (Java properties), `strings` (iOS/macOS strings), `md` / `markdown`, `resx` (.NET resources), `odt` (OpenDocument Text), and `rtf` (Rich Text Format).
 - A new `input_conversion_options` parameter controls how the input document is converted before translation. The `suppress-image-types` option leaves specified types of images embedded in `pptx` documents untranslated. For example, `version:1,suppress-image-types:all` suppresses all embedded images, and `version:1,suppress-image-types:logo-photo` suppresses logos and photos only.

docs/voice/supported-voice-languages.mdx

@@ -49,6 +49,7 @@ Translation is always provided by DeepL. For some languages, transcription and t
 | Slovak | ⎋ | ✓ | ⎋ |
 | Slovenian | ⎋ | ✓ | ⎋ |
 | Spanish | ✓ | ✓ | ✓ |
+| Spanish (Latin American) <Badge color="blue">beta</Badge> | ✓ | ✓ | ⎋ |
 | Swedish | ✓ | ✓ | ✓ |
 | Tagalog | ⎋ | ✓ | ⎋ |
 | Tamil <Badge color="blue">beta</Badge> | ⎋ | ✓ | ⎋ |

scripts/generate-voice-languages.mjs

@@ -20,8 +20,9 @@ export async function update({ authKey, dryRun = false }) {
   const languagesByCode = new Map(languages.map((language) => [language.lang, language]));
 
   const rows = languages
-    // Skip the row for a base language if variants are available
-    .filter((l) => l.lang.includes('-') || !languages.some((f) => f.lang.startsWith(`${l.lang}-`)))
+    // Skip the row for a base language if two or more variants cover it (e.g. fr-CA + fr-FR).
+    // A single variant (e.g. es-419 without es-ES) leaves the base row as the other variety.
+    .filter((l) => l.lang.includes('-') || languages.filter((f) => f.lang.startsWith(`${l.lang}-`)).length < 2)
     .sort(byName)
     .map((l) => {
       const isVariant = l.lang.includes('-');