Skip to content

Commit c60442d

Browse files
authored
fix(AIP-143): strengthen country/region field naming rationale (#1452)
1 parent ca24fae commit c60442d

1 file changed

Lines changed: 16 additions & 3 deletions

File tree

aip/general/0143.md

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -61,9 +61,8 @@ Fields representing individual countries or nations **must** use the [Unicode
6161
CLDR 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
8887
these are subtly different). In this case, the field **must** use the [ISO-8601
8988
format][] 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

Comments
 (0)