From d59a9208341a483ff487013ff3594335e615eae4 Mon Sep 17 00:00:00 2001 From: JarbasAi Date: Sat, 4 Jul 2026 13:59:40 +0100 Subject: [PATCH] =?UTF-8?q?docs:=20INTENT-2=20consistency=20review=20?= =?UTF-8?q?=E2=80=94=20implementation-neutral=20language=20fallback?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The §2.2 language-fallback suggestion no longer names a specific library or its numeric distance threshold; a loader MAY fall back to the nearest available language as measured by any language-tag distance metric that treats close regional variants as usable matches. The fallback remains an implementation choice, not a requirement. Co-Authored-By: Claude Opus 4.8 --- CHANGELOG.md | 5 +++++ intent-2.md | 6 +++--- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ad47b454..5698b652 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -132,6 +132,11 @@ version 2: its `{{ … }}` sequences become substitution points, and its engine extracts only the slots of the matched template. The prior "every line MUST declare the same set of slots; use a separate file" rule is dropped for `.intent` (it still holds for `.dialog`, §4.2). +- Consistency review: §2.2 language-fallback suggestion made + implementation-neutral — a loader MAY fall back to the nearest + available language as measured by any language-tag distance metric + that treats close regional variants as usable matches; the reference + to one particular library and its numeric threshold is removed. ### 1 diff --git a/intent-2.md b/intent-2.md index cb1b3cdd..89e74c7e 100644 --- a/intent-2.md +++ b/intent-2.md @@ -126,9 +126,9 @@ an override file replaces the corresponding lower-precedence file entirely. This specification does not mandate behaviour when the requested language has no directory. A loader **SHOULD** prefer an exact match. As a *suggestion*, a -loader MAY fall back to the nearest available language; the `langcodes` library -provides a `tag_distance()` function for this, and treats a distance below `10` -as a usable regional match. Any such fallback is an **implementation choice**, +loader MAY fall back to the nearest available language, as measured by any +language-tag distance metric that treats close regional variants as usable +matches. Any such fallback is an **implementation choice**, not a requirement of this specification, because cross-region substitution can produce wording a user would not expect.