CLDR-17948 v46 keyboard spec: update conformsTo docs (#4118)

unicode-org · Oct 9, 2024 · a4ea32e · a4ea32e
1 parent bdcfab7
commit a4ea32e
Show file tree

Hide file tree

Showing 9 changed files with 38 additions and 3 deletions.
diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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" />