From 2c9e0b8cfa2fea4f861be019ad23d11ff36613cf Mon Sep 17 00:00:00 2001
From: Matt Mayer <152770+matthewmayer@users.noreply.github.com>
Date: Wed, 29 Mar 2023 16:21:02 +0700
Subject: docs(location): improve documentation for state and county (#1987)

---
 src/modules/location/index.ts | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

(limited to 'src/modules')

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
    */
-- 
cgit v1.2.3