docs: clarify that location.state refers to ISO 3166-2 (#2574)

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.