diff --git a/src/modules/location/index.ts b/src/modules/location/index.ts index e7bde32e1a6..6d15741dc7e 100644 --- a/src/modules/location/index.ts +++ b/src/modules/location/index.ts @@ -372,6 +372,9 @@ export class LocationModule extends ModuleBase { /** * Returns a random localized state, or other equivalent first-level administrative entity for the locale's country such as a province or region. + * Generally, these are the ISO 3166-2 subdivisions for a country. + * If a locale doesn't correspond to one specific country, the method may return ISO 3166-2 subdivisions from one or more countries that uses that language. For example, the `ar` locale includes subdivisions from Arabic-speaking countries, such as Tunisia, Algeria, Syria, Lebanon, etc. + * For historical compatibility reasons, the default `en` locale only includes states in the United States (identical to `en_US`). However, you can use other English locales, such as `en_IN`, `en_GB`, and `en_AU`, if needed. * * @param options An options object. * @param options.abbreviated If true this will return abbreviated first-level administrative entity names.