@@ -61,9 +61,8 @@ Fields representing individual countries or nations **must** use the [Unicode
6161CLDR region codes] [ cldr ] ([ list] [ ] ), such as ` US ` or ` CH ` , and the field
6262** must** be called ` region_code ` .
6363
64- ** Important:** We use ` region_code ` and not ` country_code ` to include regions
65- distinct from any country, and avoid political disputes over whether or not
66- some regions are countries.
64+ ** Important:** Please read the [ rationale] ( #countryregion-field-naming ) for this
65+ requirement.
6766
6867### Currency
6968
@@ -88,8 +87,22 @@ Fields also **may** represent a UTC offset rather than a time zone (note that
8887these are subtly different). In this case, the field ** must** use the [ ISO-8601
8988format] [ ] to represent this, and the field ** must** be named ` utc_offset ` .
9089
90+ ## Rationale
91+
92+ ### Country/region field naming
93+
94+ The use of ` region_code ` instead of ` country_code ` is critical to being able to
95+ convey regions that are distinct from any country and to avoid any political
96+ disputes associated with said region regarding their soverignty or affiliation.
97+ Google and many other companies are supporters of Unicode CLDR and standardize
98+ their product internationalization efforts on Unicode CLDR, and APIs are no
99+ different here. Furthermore, many of the values supported by Unicode CLDR are
100+ not countries on their own, so using a more generic name is actually more
101+ compatible with the specification.
102+
91103## Changelog
92104
105+ - ** 2024-12-03** : Strengthen rationale of country/region field naming
93106- ** 2024-11-12** : Change country/region code list to CLDR list from IANA list
94107- ** 2020-05-12** : Replaced ` country_code ` guidance with ` region_code ` ,
95108 correcting an original error.
0 commit comments