docs: deprecation workflow (#1067)

Co-authored-by: Eric Cheng <[email protected]>

4 files changed, 23 insertions, 18 deletions

diff --git a/src/modules/address/index.ts b/src/modules/address/index.ts
index e3c568fd..7c55bb51 100644
--- a/src/modules/address/index.ts
+++ b/src/modules/address/index.ts
@@ -76,8 +76,8 @@ export class Address {
       deprecated({
         deprecated: 'faker.address.city(format)',
         proposed: 'faker.address.city() or faker.fake(format)',
-        since: 'v7.0',
-        until: 'v8.0',
+        since: '7.0',
+        until: '8.0',
       });
     }
     const formats = this.faker.definitions.address.city;
@@ -98,13 +98,14 @@ export class Address {
    * faker.address.cityPrefix() // 'East'
    *
    * @deprecated
+   * Use `faker.address.city()` instead.
    */
   cityPrefix(): string {
     deprecated({
       deprecated: 'faker.address.cityPrefix()',
       proposed: "faker.address.city() or faker.fake('{{address.city_prefix}}')",
-      since: 'v7.2',
-      until: 'v8.0',
+      since: '7.2',
+      until: '8.0',
     });
     return this.faker.helpers.arrayElement(
       this.faker.definitions.address.city_prefix
@@ -120,13 +121,14 @@ export class Address {
    * faker.address.citySuffix() // 'mouth'
    *
    * @deprecated
+   * Use `faker.address.city()` instead.
    */
   citySuffix(): string {
     deprecated({
       deprecated: 'faker.address.citySuffix()',
       proposed: "faker.address.city() or faker.fake('{{address.city_suffix}}')",
-      since: 'v7.2',
-      until: 'v8.0',
+      since: '7.2',
+      until: '8.0',
     });
     return this.faker.helpers.arrayElement(
       this.faker.definitions.address.city_suffix
@@ -185,8 +187,8 @@ export class Address {
           'faker.address.streetName() without address.street_name definitions',
         proposed:
           'faker.address.street() or provide address.street_name definitions',
-        since: 'v7.0',
-        until: 'v8.0',
+        since: '7.0',
+        until: '8.0',
       });
       return this.street();
     }
diff --git a/src/modules/commerce/index.ts b/src/modules/commerce/index.ts
index d17c473b..2dcb4ca3 100644
--- a/src/modules/commerce/index.ts
+++ b/src/modules/commerce/index.ts
@@ -22,13 +22,14 @@ export class Commerce {
    * faker.commerce.color() // 'red'
    *
    * @deprecated
+   * Use `faker.color.human()` instead.
    */
   color(): string {
     deprecated({
       deprecated: 'faker.commerce.color()',
       proposed: 'faker.color.human()',
-      since: 'v7.0.0',
-      until: 'v8.0.0',
+      since: '7.0',
+      until: '8.0',
     });
     return this.faker.color.human();
   }
diff --git a/src/modules/phone/index.ts b/src/modules/phone/index.ts
index 68f97bf6..08da0821 100644
--- a/src/modules/phone/index.ts
+++ b/src/modules/phone/index.ts
@@ -33,8 +33,8 @@ export class Phone {
     deprecated({
       deprecated: 'faker.phone.phoneNumber()',
       proposed: 'faker.phone.number()',
-      since: 'v7.3',
-      until: 'v8.0',
+      since: '7.3',
+      until: '8.0',
     });
     return this.faker.phone.number(format);
   }
@@ -71,14 +71,15 @@ export class Phone {
    * faker.phone.phoneNumberFormat(3) // '282.652.3201'
    *
    * @deprecated
+   * Use faker.phone.phoneNumber() instead.
    */
   phoneNumberFormat(phoneFormatsArrayIndex = 0): string {
     deprecated({
       deprecated: 'faker.phone.phoneNumberFormat()',
       proposed:
         'faker.phone.phoneNumber() or faker.helpers.replaceSymbolWithNumber(format)',
-      since: 'v7.0',
-      until: 'v8.0',
+      since: '7.0',
+      until: '8.0',
     });
     return this.faker.helpers.replaceSymbolWithNumber(
       this.faker.definitions.phone_number.formats[phoneFormatsArrayIndex]
@@ -95,13 +96,14 @@ export class Phone {
    * faker.phone.phoneFormats() // '!##.!##.####'
    *
    * @deprecated
+   * Use `faker.phone.phoneNumber()` instead.
    */
   phoneFormats(): string {
     deprecated({
       deprecated: 'faker.phone.phoneFormats()',
       proposed: 'faker.phone.phoneNumber()',
-      since: 'v7.0',
-      until: 'v8.0',
+      since: '7.0',
+      until: '8.0',
     });
     return this.faker.helpers.arrayElement(
       this.faker.definitions.phone_number.formats
diff --git a/src/modules/random/index.ts b/src/modules/random/index.ts
index 616dc4dd..727ec8fb 100644
--- a/src/modules/random/index.ts
+++ b/src/modules/random/index.ts
@@ -273,8 +273,8 @@ export class Random {
       deprecated({
         deprecated: 'faker.random.alpha({ upcase: true })',
         proposed: "faker.random.alpha({ casing: 'upper' })",
-        since: 'v7.0',
-        until: 'v8.0',
+        since: '7.0',
+        until: '8.0',
       });
     }