[latex3-commits] [git/LaTeX3-latex3-babel] docs: New page: locale naming. (50a1332)

[Javier]

Repository : https://github.com/latex3/babel
On branch  : docs
Link       : https://github.com/latex3/babel/commit/50a1332b7b312ce18a34fdd094613c2cc903978b

>---------------------------------------------------------------

commit 50a1332b7b312ce18a34fdd094613c2cc903978b
Author: Javier <email at localhost>
Date:   Sat May 21 13:39:31 2022 +0200

    New page: locale naming.


>---------------------------------------------------------------

50a1332b7b312ce18a34fdd094613c2cc903978b
 docs/_includes/menu.html             |  5 +++--
 docs/guides/locale-naming.md         | 25 +++++++++++++++++++++++++
 docs/news/whats-new-in-babel-3.75.md |  4 ++++
 3 files changed, 32 insertions(+), 2 deletions(-)

diff --git a/docs/_includes/menu.html b/docs/_includes/menu.html
index f6436b9..1a8d65f 100644
--- a/docs/_includes/menu.html
+++ b/docs/_includes/menu.html
@@ -28,10 +28,11 @@
       <li><a href="#">Guides</a>
       <ul>
         <li><a href="https://latex3.github.io/babel/guides/which-method-for-which-language.html">Which method for which language</a></li>
-        <li><a href="https://latex3.github.io/babel/guides/non-standard-hyphenation-with-luatex.html">Non-standard hyphenation with  luatex</a></li>
+        <li><a href="https://latex3.github.io/babel/guides/non-standard-hyphenation-with-luatex.html">Non-standard hyphenation with luatex</a></li>
         <li><a href="https://latex3.github.io/babel/guides/using-babelprovide-to-modify-or-extend-locales.html">Using \babelprovide to modify or extend locales</a></li>
-        <li><a href="https://latex3.github.io/babel/guides/useful-links-to-tex.stackexchange.html">Useful links to   tex.strackexchange</a></li>
+        <li><a href="https://latex3.github.io/babel/guides/useful-links-to-tex.stackexchange.html">Useful links to tex.strackexchange</a></li>
         <li><a href="https://latex3.github.io/babel/guides/keys-in-ini-files.html">Keys in ini files</a></li>
+        <li><a href="https://latex3.github.io/babel/guides/locale-naming.html">Locale naming</a></li>
         <li><a href="https://latex3.github.io/babel/guides/old-and-deprecated-functions.html">Old and deprecated functions</a></li>
         <li><a href="https://latex3.github.io/babel/guides/list-of-locale-templates.html">List of locale templates</a></li>
         <li><a href="https://latex3.github.io/babel/guides/using-babel-with-plain.html">Using babel with plain</a></li>
diff --git a/docs/guides/locale-naming.md b/docs/guides/locale-naming.md
new file mode 100644
index 0000000..5aaea95
--- /dev/null
+++ b/docs/guides/locale-naming.md
@@ -0,0 +1,25 @@
+# Locale naming
+
+*Draft*
+
+For the naming of the locales at the user level, the following
+conventions will be used. 
+
+Languages, and therefore the corresponding files, are named with the
+English name, lowercased and without spaces: `northernkurdish`. Hyphens
+separate other fields, like script and region: `serbian-latin`,
+`spanish-mexico`. They are taken from the CLDR.
+
+Wherever the CLDR doesn’t provide a name (eg, “Medieval Latin”), the
+pattern followed in practice for other names is applied, namely, use
+the ‘natural’ form in English: `medievallatin`. They should be
+preferably based on the description field in the
+[IANA](https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry)
+registry (eg, `polytonicgreek`), although some simplifications can be
+necessary, because some names are “too” descriptive.
+
+A few locales with a region or a script have in the CLDR a more precise
+name. For example, `ro-MD` is “Moldavian”. They will be normalized in
+`babel` in the next few releases.
+
+
diff --git a/docs/news/whats-new-in-babel-3.75.md b/docs/news/whats-new-in-babel-3.75.md
index 0d9ad14..a7f94fb 100644
--- a/docs/news/whats-new-in-babel-3.75.md
+++ b/docs/news/whats-new-in-babel-3.75.md
@@ -12,6 +12,10 @@ files, which were load loaded only in some cases, except with
 minimal overhead. This should work for most languages, but see the
 following section.
 
+Because of the way this feature works, problems are very unlikely, but
+there is switch as a package option to turn the new behavior off
+(`ensureinfo=off`).
+
 ## Language naming with `babel` and the Unicode CLDR
 
 In the coming few weeks (or months), `babel` will attempt to align the