aboutsummaryrefslogtreecommitdiff
path: root/src/modules
diff options
context:
space:
mode:
Diffstat (limited to 'src/modules')
-rw-r--r--src/modules/location/index.ts3
1 files changed, 3 insertions, 0 deletions
diff --git a/src/modules/location/index.ts b/src/modules/location/index.ts
index e7bde32e..6d15741d 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.