refactor(person)!: flatten jobs definitions (#2505)

1 files changed, 9 insertions, 0 deletions

diff --git a/docs/guide/upgrading_v9/2505.md b/docs/guide/upgrading_v9/2505.md
new file mode 100644
index 00000000..d72ed9e2
--- /dev/null
+++ b/docs/guide/upgrading_v9/2505.md
@@ -0,0 +1,9 @@
+### Jobs definitions reorganized
+
+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`       |