aboutsummaryrefslogtreecommitdiff
path: root/docs/guide/upgrading.md
diff options
context:
space:
mode:
authorDivisionByZero <[email protected]>2024-06-30 19:06:31 +0200
committerGitHub <[email protected]>2024-06-30 19:06:31 +0200
commite21fcaf2398dfd9aed54136524fabd39866dfca4 (patch)
tree1c91c07cfd517f935540becee692b2dae70304e0 /docs/guide/upgrading.md
parent92a2f178343f4413bd6d782a7957eda86aa1b7b8 (diff)
downloadfaker-e21fcaf2398dfd9aed54136524fabd39866dfca4.tar.xz
faker-e21fcaf2398dfd9aed54136524fabd39866dfca4.zip
refactor(locale): group person entries by gender (#2938)
Diffstat (limited to 'docs/guide/upgrading.md')
-rw-r--r--docs/guide/upgrading.md29
1 files changed, 22 insertions, 7 deletions
diff --git a/docs/guide/upgrading.md b/docs/guide/upgrading.md
index 82148296..4d9ae22d 100644
--- a/docs/guide/upgrading.md
+++ b/docs/guide/upgrading.md
@@ -486,13 +486,28 @@ Removed deprecated number parameter
#### Changed Definitions
-The locale definitions used by `faker.person.jobTitle()`, `faker.person.jobDescriptor()`, `faker.person.jobArea()` and `faker.person.jobType()` have been reorganized and are no longer nested under `definitions.person.title`. If you are using the public methods, no changes are required. You only need to change your code if you are accessing the raw definitions e.g. in `faker.helpers.fake()`.
-
-| Before | After |
-| ------------------------- | ----------------------- |
-| `person.title.descriptor` | `person.job_descriptor` |
-| `person.title.level` | `person.job_area` |
-| `person.title.job` | `person.job_type` |
+The locale definitions used by `faker.person.jobTitle()`, `faker.person.jobDescriptor()`, `faker.person.jobArea()` and `faker.person.jobType()` have been reorganized and are no longer nested under `definitions.person.title`. Conversely, the gendered locale definitions used by `faker.person.firstName()`, `faker.person.lastName()`, `faker.person.middleName()` and `faker.person.prefix()` are now consolidated under a single definition property. If you are using the public methods, no changes are required. You only need to change your code if you are accessing the raw definitions e.g. in `faker.helpers.fake()`.
+
+| Before | After |
+| --------------------------------- | ---------------------------------- |
+| `person.female_first_name` | `person.first_name.female` |
+| `person.female_last_name_pattern` | `person.last_name_pattern.female` |
+| `person.female_last_name` | `person.last_name.female` |
+| `person.female_middle_name` | `person.middle_name.female` |
+| `person.female_prefix` | `person.prefix.female` |
+| `person.first_name` | `person.first_name.generic` |
+| `person.last_name_pattern` | `person.last_name_pattern.generic` |
+| `person.last_name` | `person.last_name.generic` |
+| `person.male_first_name` | `person.first_name.male` |
+| `person.male_last_name_pattern` | `person.last_name_pattern.male` |
+| `person.male_last_name` | `person.last_name.male` |
+| `person.male_middle_name` | `person.middle_name.male` |
+| `person.male_prefix` | `person.prefix.male` |
+| `person.middle_name` | `person.middle_name.generic` |
+| `person.prefix` | `person.prefix.generic` |
+| `person.title.descriptor` | `person.job_descriptor` |
+| `person.title.job` | `person.job_type` |
+| `person.title.level` | `person.job_area` |
### Phone Module