From a4ea32eff9d590a6da99fa77e483412950d85a07 Mon Sep 17 00:00:00 2001
From: "Steven R. Loomis" <srl295@gmail.com>
Date: Wed, 9 Oct 2024 14:04:20 -0500
Subject: [PATCH] CLDR-17948 v46 keyboard spec: update conformsTo docs (#4118)

---
 docs/ldml/tr35-keyboards.md           | 9 ++++++---
 keyboards/3.0/bn.xml                  | 4 ++++
 keyboards/3.0/fr.xml                  | 4 ++++
 keyboards/3.0/ja-Hira-t-k0-flicks.xml | 4 ++++
 keyboards/3.0/ja-Latn.xml             | 4 ++++
 keyboards/3.0/mt-t-k0-47key.xml       | 4 ++++
 keyboards/3.0/mt.xml                  | 4 ++++
 keyboards/3.0/pcm.xml                 | 4 ++++
 keyboards/3.0/pt-t-k0-abnt2.xml       | 4 ++++
 9 files changed, 38 insertions(+), 3 deletions(-)

diff --git a/docs/ldml/tr35-keyboards.md b/docs/ldml/tr35-keyboards.md
index 99225bf9b94..3fc01367394 100644
--- a/docs/ldml/tr35-keyboards.md
+++ b/docs/ldml/tr35-keyboards.md
@@ -626,10 +626,13 @@ This is the top level element. All other elements defined below are under this e
 
 _Attribute:_ `conformsTo` (required)
 
-This attribute value distinguishes the keyboard from prior versions,
-and it also specifies the minimum CLDR major version required.
+This attribute value specifies the minimum supported CLDR major version required to properly interpret this keyboard.
 
-This attribute value must be a whole number of `45` or greater. See [`cldrVersion`](tr35-info.md#version-information)
+The value must be a whole number of `45` or greater. See [`cldrVersion`](tr35-info.md#version-information)
+
+CLDR's stability policy is such that keyboards which conform to a CLDR version automatically are conformant to all future versions. In other words, a layout with `conformsTo="45"` could be changed to `conformsTo="46"` with no other changes and the layout would remain conformant.
+
+To promote wider interchange, authors and tooling should use the minimum `conformsTo` value necessary to support the keyboard.
 
 ```xml
 <keyboard3 … conformsTo="45"/>
diff --git a/keyboards/3.0/bn.xml b/keyboards/3.0/bn.xml
index b579e39f389..800f71d7a9a 100644
--- a/keyboards/3.0/bn.xml
+++ b/keyboards/3.0/bn.xml
@@ -1,4 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Note: conformsTo= references a previous release here,
+  because this keyboard does not depend on schema or data from later CLDR versions.
+-->
 <keyboard3 xmlns="https://schemas.unicode.org/cldr/45/keyboard3" locale="bn" conformsTo="45">
     <!--
         History:
diff --git a/keyboards/3.0/fr.xml b/keyboards/3.0/fr.xml
index 45871726c06..8e6c8b15192 100644
--- a/keyboards/3.0/fr.xml
+++ b/keyboards/3.0/fr.xml
@@ -1,4 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Note: conformsTo= references a previous release here,
+  because this keyboard does not depend on schema or data from later CLDR versions.
+-->
 <keyboard3 xmlns="https://schemas.unicode.org/cldr/45/keyboard3" conformsTo="45"
 	locale="fr">
 	<version number="1.0.0" />
diff --git a/keyboards/3.0/ja-Hira-t-k0-flicks.xml b/keyboards/3.0/ja-Hira-t-k0-flicks.xml
index c10342320a0..6448542a261 100644
--- a/keyboards/3.0/ja-Hira-t-k0-flicks.xml
+++ b/keyboards/3.0/ja-Hira-t-k0-flicks.xml
@@ -1,4 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Note: conformsTo= references a previous release here,
+  because this keyboard does not depend on schema or data from later CLDR versions.
+-->
 <keyboard3 xmlns="https://schemas.unicode.org/cldr/45/keyboard3" locale="ja-Hira-t-k0-flicks"
 	conformsTo="45">
 	<version number="1.0.0" />
diff --git a/keyboards/3.0/ja-Latn.xml b/keyboards/3.0/ja-Latn.xml
index a2ffda522a9..2758d077e85 100644
--- a/keyboards/3.0/ja-Latn.xml
+++ b/keyboards/3.0/ja-Latn.xml
@@ -1,4 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Note: conformsTo= references a previous release here,
+  because this keyboard does not depend on schema or data from later CLDR versions.
+-->
 <keyboard3 xmlns="https://schemas.unicode.org/cldr/45/keyboard3" locale="ja-Latn" conformsTo="45">
 	<locales>
 		<locale id="en" />
diff --git a/keyboards/3.0/mt-t-k0-47key.xml b/keyboards/3.0/mt-t-k0-47key.xml
index 9c7ed0fcccd..6a875b37f2d 100644
--- a/keyboards/3.0/mt-t-k0-47key.xml
+++ b/keyboards/3.0/mt-t-k0-47key.xml
@@ -1,4 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Note: conformsTo= references a previous release here,
+  because this keyboard does not depend on schema or data from later CLDR versions.
+-->
 <keyboard3 xmlns="https://schemas.unicode.org/cldr/45/keyboard3" locale="mt-t-k0-47key" conformsTo="45">
     <locales>
         <!-- English is also an official language in Malta.-->
diff --git a/keyboards/3.0/mt.xml b/keyboards/3.0/mt.xml
index d552888f7ed..b76b08cd9a8 100644
--- a/keyboards/3.0/mt.xml
+++ b/keyboards/3.0/mt.xml
@@ -4,6 +4,10 @@ Copyright © 1991-2024 Unicode, Inc.
 SPDX-License-Identifier: Unicode-3.0
 CLDR data files are interpreted according to the LDML specification (http://unicode.org/reports/tr35/)
 -->
+<!--
+  Note: conformsTo= references a previous release here,
+  because this keyboard does not depend on schema or data from later CLDR versions.
+-->
 <keyboard3 xmlns="https://schemas.unicode.org/cldr/45/keyboard3" locale="mt" conformsTo="45">
     <locales>
         <!-- English is also an official language in Malta.-->
diff --git a/keyboards/3.0/pcm.xml b/keyboards/3.0/pcm.xml
index 84473302841..cf8002f94dc 100644
--- a/keyboards/3.0/pcm.xml
+++ b/keyboards/3.0/pcm.xml
@@ -1,4 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Note: conformsTo= references a previous release here,
+  because this keyboard does not depend on schema or data from later CLDR versions.
+-->
 <keyboard3 xmlns="https://schemas.unicode.org/cldr/45/keyboard3" locale="pcm" conformsTo="45">
   <version number="1.0.0" />
   <info name="Naijíriá Píjin" />
diff --git a/keyboards/3.0/pt-t-k0-abnt2.xml b/keyboards/3.0/pt-t-k0-abnt2.xml
index d612141166e..003d1a6af2f 100644
--- a/keyboards/3.0/pt-t-k0-abnt2.xml
+++ b/keyboards/3.0/pt-t-k0-abnt2.xml
@@ -1,4 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Note: conformsTo= references a previous release here,
+  because this keyboard does not depend on schema or data from later CLDR versions.
+-->
 <keyboard3 xmlns="https://schemas.unicode.org/cldr/45/keyboard3" locale="pt-t-k0-abnt2" conformsTo="45">
 	<locales>
 		<locale id="pt" />