From a478715fe60c5f52a43924e4fdede502caaeb701 Mon Sep 17 00:00:00 2001
From: Junior Dev Agent <288084488+junior-ai-bot[bot]@users.noreply.github.com>
Date: Mon, 14 Sep 2026 13:05:05 +0000
Subject: [PATCH] STRINGS-3250 - enrich cldr_version field description on
 project create/update

The project-level cldr_version field only had a terse description with no
explanation of the legacy/CLDR48 distinction, unlike POST /icu/skeleton's
richer (but search-unreachable) description of the same enum. Mirror that
text on POST /projects and PATCH /projects/{id} so the distinction is
discoverable from the field users actually interact with.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 doc/compiled.json          | 4 ++--
 paths/projects/create.yaml | 7 ++++++-
 paths/projects/update.yaml | 7 ++++++-
 3 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/doc/compiled.json b/doc/compiled.json
index 54c63eec0..b0e457e82 100644
--- a/doc/compiled.json
+++ b/doc/compiled.json
@@ -18183,7 +18183,7 @@
                     ]
                   },
                   "cldr_version": {
-                    "description": "(Optional) CLDR plural-rule version used by the project.",
+                    "description": "(Optional) CLDR plural-rule version used by the project. Pass `legacy` for pre-CLDR pluralization behaviour, or a CLDR version string such as `cldr48`. Also used as the default version for the ICU skeleton endpoint (`POST /icu/skeleton`) when its own `cldr_version` parameter is omitted.",
                     "type": "string",
                     "example": "cldr48"
                   },
@@ -18543,7 +18543,7 @@
                     "example": "unicode_ci"
                   },
                   "cldr_version": {
-                    "description": "(Optional) CLDR plural-rule version used by the project.",
+                    "description": "(Optional) CLDR plural-rule version used by the project. Pass `legacy` for pre-CLDR pluralization behaviour, or a CLDR version string such as `cldr48`. Also used as the default version for the ICU skeleton endpoint (`POST /icu/skeleton`) when its own `cldr_version` parameter is omitted.",
                     "type": "string",
                     "example": "legacy"
                   }
diff --git a/paths/projects/create.yaml b/paths/projects/create.yaml
index 6f174aa50..f0bcb125b 100644
--- a/paths/projects/create.yaml
+++ b/paths/projects/create.yaml
@@ -214,7 +214,12 @@ requestBody:
               - "UTF-16LE"
               - "ISO-8859-1"
           cldr_version:
-            description: "(Optional) CLDR plural-rule version used by the project."
+            description: >-
+              (Optional) CLDR plural-rule version used by the project. Pass
+              `legacy` for pre-CLDR pluralization behaviour, or a CLDR
+              version string such as `cldr48`. Also used as the default
+              version for the ICU skeleton endpoint (`POST /icu/skeleton`)
+              when its own `cldr_version` parameter is omitted.
             type: string
             example: "cldr48"
           placeholder_styles:
diff --git a/paths/projects/update.yaml b/paths/projects/update.yaml
index 10a7941b9..09d0c1252 100644
--- a/paths/projects/update.yaml
+++ b/paths/projects/update.yaml
@@ -217,7 +217,12 @@ requestBody:
             type: string
             example: unicode_ci
           cldr_version:
-            description: "(Optional) CLDR plural-rule version used by the project."
+            description: >-
+              (Optional) CLDR plural-rule version used by the project. Pass
+              `legacy` for pre-CLDR pluralization behaviour, or a CLDR
+              version string such as `cldr48`. Also used as the default
+              version for the ICU skeleton endpoint (`POST /icu/skeleton`)
+              when its own `cldr_version` parameter is omitted.
             type: string
             example: "legacy"
 x-cli-version: "2.6.3"