docs(location): improve documentation for state and county (#1987)

1 files changed, 6 insertions, 4 deletions

diff --git a/src/modules/location/index.ts b/src/modules/location/index.ts
index fb902588..37d8f14f 100644
--- a/src/modules/location/index.ts
+++ b/src/modules/location/index.ts
@@ -228,10 +228,10 @@ export class LocationModule {
   }
 
   /**
-   * Returns a random localized county.
+   * Returns a random localized county, or other equivalent second-level administrative entity for the locale's country such as a district or department.
    *
    * @example
-   * faker.location.county() // 'Cambridgeshire'
+   * fakerEN_GB.location.county() // 'Cambridgeshire'
    *
    * @since 8.0.0
    */
@@ -297,10 +297,12 @@ export class LocationModule {
   }
 
   /**
-   * Returns a random localized state from this country.
+   * Returns a random localized state, or other equivalent first-level administrative entity for the locale's country such as a province or region.
    *
    * @example
-   * faker.location.state() // 'Georgia'
+   * faker.location.state() // 'Mississippi'
+   * fakerEN_CA.location.state() // 'Saskatchewan'
+   * fakerDE.location.state() // 'Nordrhein-Westfalen'
    *
    * @since 8.0.0
    */