refactor(company)!: rename bs to buzz (#1860)

30 files changed, 139 insertions, 59 deletions

diff --git a/src/definitions/company.ts b/src/definitions/company.ts
index 6d70cb36..257a2912 100644
--- a/src/definitions/company.ts
+++ b/src/definitions/company.ts
@@ -5,27 +5,27 @@ import type { LocaleEntry } from './definitions';
  */
 export type CompanyDefinitions = LocaleEntry<{
   /**
-   * Business/products related adjectives.
+   * Business/products related adjectives that can be used to demonstrate data being viewed by a manager.
    */
-  bs_adjective: string[];
+  buzz_adjective: string[];
 
   /**
-   * Business/products related nouns.
+   * Business/products related nouns that can be used to demonstrate data being viewed by a manager.
    */
-  bs_noun: string[];
+  buzz_noun: string[];
 
   /**
-   * Business/products related verbs.
+   * Business/products related verbs that can be used to demonstrate data being viewed by a manager.
    */
-  bs_verb: string[];
+  buzz_verb: string[];
 
   /**
-   * Catchphrase adjectives.
+   * Catchphrase adjectives that can be displayed to an end user.
    */
   adjective: string[];
 
   /**
-   * Catchphrase descriptors.
+   * Catchphrase descriptors that can be displayed to an end user.
    */
   descriptor: string[];
 
@@ -35,7 +35,7 @@ export type CompanyDefinitions = LocaleEntry<{
   name_patterns: string[];
 
   /**
-   * Catchphrase nouns.
+   * Catchphrase nouns that can be displayed to an end user.
    */
   noun: string[];
 
diff --git a/src/locales/el/company/bs_adjective.ts b/src/locales/el/company/buzz_adjective.ts
index 13497d68..13497d68 100644
--- a/src/locales/el/company/bs_adjective.ts
+++ b/src/locales/el/company/buzz_adjective.ts
diff --git a/src/locales/el/company/bs_noun.ts b/src/locales/el/company/buzz_noun.ts
index 9604c1e7..9604c1e7 100644
--- a/src/locales/el/company/bs_noun.ts
+++ b/src/locales/el/company/buzz_noun.ts
diff --git a/src/locales/el/company/bs_verb.ts b/src/locales/el/company/buzz_verb.ts
index 27a54b6d..27a54b6d 100644
--- a/src/locales/el/company/bs_verb.ts
+++ b/src/locales/el/company/buzz_verb.ts
diff --git a/src/locales/el/company/index.ts b/src/locales/el/company/index.ts
index 7875f08b..ad4d1c3b 100644
--- a/src/locales/el/company/index.ts
+++ b/src/locales/el/company/index.ts
@@ -4,9 +4,9 @@
  */
 import type { CompanyDefinitions } from '../../..';
 import adjective from './adjective';
-import bs_adjective from './bs_adjective';
-import bs_noun from './bs_noun';
-import bs_verb from './bs_verb';
+import buzz_adjective from './buzz_adjective';
+import buzz_noun from './buzz_noun';
+import buzz_verb from './buzz_verb';
 import descriptor from './descriptor';
 import name_patterns from './name_patterns';
 import noun from './noun';
@@ -14,9 +14,9 @@ import suffix from './suffix';
 
 const company: CompanyDefinitions = {
   adjective,
-  bs_adjective,
-  bs_noun,
-  bs_verb,
+  buzz_adjective,
+  buzz_noun,
+  buzz_verb,
   descriptor,
   name_patterns,
   noun,
diff --git a/src/locales/en/company/bs_adjective.ts b/src/locales/en/company/buzz_adjective.ts
index 9fed1f1e..9fed1f1e 100644
--- a/src/locales/en/company/bs_adjective.ts
+++ b/src/locales/en/company/buzz_adjective.ts
diff --git a/src/locales/en/company/bs_noun.ts b/src/locales/en/company/buzz_noun.ts
index b62bdbef..b62bdbef 100644
--- a/src/locales/en/company/bs_noun.ts
+++ b/src/locales/en/company/buzz_noun.ts
diff --git a/src/locales/en/company/bs_verb.ts b/src/locales/en/company/buzz_verb.ts
index 405efc3c..405efc3c 100644
--- a/src/locales/en/company/bs_verb.ts
+++ b/src/locales/en/company/buzz_verb.ts
diff --git a/src/locales/en/company/index.ts b/src/locales/en/company/index.ts
index 7875f08b..ad4d1c3b 100644
--- a/src/locales/en/company/index.ts
+++ b/src/locales/en/company/index.ts
@@ -4,9 +4,9 @@
  */
 import type { CompanyDefinitions } from '../../..';
 import adjective from './adjective';
-import bs_adjective from './bs_adjective';
-import bs_noun from './bs_noun';
-import bs_verb from './bs_verb';
+import buzz_adjective from './buzz_adjective';
+import buzz_noun from './buzz_noun';
+import buzz_verb from './buzz_verb';
 import descriptor from './descriptor';
 import name_patterns from './name_patterns';
 import noun from './noun';
@@ -14,9 +14,9 @@ import suffix from './suffix';
 
 const company: CompanyDefinitions = {
   adjective,
-  bs_adjective,
-  bs_noun,
-  bs_verb,
+  buzz_adjective,
+  buzz_noun,
+  buzz_verb,
   descriptor,
   name_patterns,
   noun,
diff --git a/src/locales/es_MX/company/bs_adjective.ts b/src/locales/es_MX/company/buzz_adjective.ts
index 11ff2a9d..11ff2a9d 100644
--- a/src/locales/es_MX/company/bs_adjective.ts
+++ b/src/locales/es_MX/company/buzz_adjective.ts
diff --git a/src/locales/es_MX/company/bs_noun.ts b/src/locales/es_MX/company/buzz_noun.ts
index 2abf0f06..2abf0f06 100644
--- a/src/locales/es_MX/company/bs_noun.ts
+++ b/src/locales/es_MX/company/buzz_noun.ts
diff --git a/src/locales/es_MX/company/bs_verb.ts b/src/locales/es_MX/company/buzz_verb.ts
index 30a19214..30a19214 100644
--- a/src/locales/es_MX/company/bs_verb.ts
+++ b/src/locales/es_MX/company/buzz_verb.ts
diff --git a/src/locales/es_MX/company/index.ts b/src/locales/es_MX/company/index.ts
index 7875f08b..ad4d1c3b 100644
--- a/src/locales/es_MX/company/index.ts
+++ b/src/locales/es_MX/company/index.ts
@@ -4,9 +4,9 @@
  */
 import type { CompanyDefinitions } from '../../..';
 import adjective from './adjective';
-import bs_adjective from './bs_adjective';
-import bs_noun from './bs_noun';
-import bs_verb from './bs_verb';
+import buzz_adjective from './buzz_adjective';
+import buzz_noun from './buzz_noun';
+import buzz_verb from './buzz_verb';
 import descriptor from './descriptor';
 import name_patterns from './name_patterns';
 import noun from './noun';
@@ -14,9 +14,9 @@ import suffix from './suffix';
 
 const company: CompanyDefinitions = {
   adjective,
-  bs_adjective,
-  bs_noun,
-  bs_verb,
+  buzz_adjective,
+  buzz_noun,
+  buzz_verb,
   descriptor,
   name_patterns,
   noun,
diff --git a/src/locales/fa/company/bs_adjective.ts b/src/locales/fa/company/buzz_adjective.ts
index ed28c7f3..ed28c7f3 100644
--- a/src/locales/fa/company/bs_adjective.ts
+++ b/src/locales/fa/company/buzz_adjective.ts
diff --git a/src/locales/fa/company/bs_noun.ts b/src/locales/fa/company/buzz_noun.ts
index d68a71d7..d68a71d7 100644
--- a/src/locales/fa/company/bs_noun.ts
+++ b/src/locales/fa/company/buzz_noun.ts
diff --git a/src/locales/fa/company/bs_verb.ts b/src/locales/fa/company/buzz_verb.ts
index aff6eaf9..aff6eaf9 100644
--- a/src/locales/fa/company/bs_verb.ts
+++ b/src/locales/fa/company/buzz_verb.ts
diff --git a/src/locales/fa/company/index.ts b/src/locales/fa/company/index.ts
index 7875f08b..ad4d1c3b 100644
--- a/src/locales/fa/company/index.ts
+++ b/src/locales/fa/company/index.ts
@@ -4,9 +4,9 @@
  */
 import type { CompanyDefinitions } from '../../..';
 import adjective from './adjective';
-import bs_adjective from './bs_adjective';
-import bs_noun from './bs_noun';
-import bs_verb from './bs_verb';
+import buzz_adjective from './buzz_adjective';
+import buzz_noun from './buzz_noun';
+import buzz_verb from './buzz_verb';
 import descriptor from './descriptor';
 import name_patterns from './name_patterns';
 import noun from './noun';
@@ -14,9 +14,9 @@ import suffix from './suffix';
 
 const company: CompanyDefinitions = {
   adjective,
-  bs_adjective,
-  bs_noun,
-  bs_verb,
+  buzz_adjective,
+  buzz_noun,
+  buzz_verb,
   descriptor,
   name_patterns,
   noun,
diff --git a/src/locales/fr/company/bs_adjective.ts b/src/locales/fr/company/buzz_adjective.ts
index 9fed1f1e..9fed1f1e 100644
--- a/src/locales/fr/company/bs_adjective.ts
+++ b/src/locales/fr/company/buzz_adjective.ts
diff --git a/src/locales/fr/company/bs_noun.ts b/src/locales/fr/company/buzz_noun.ts
index d0cd9f3f..d0cd9f3f 100644
--- a/src/locales/fr/company/bs_noun.ts
+++ b/src/locales/fr/company/buzz_noun.ts
diff --git a/src/locales/fr/company/bs_verb.ts b/src/locales/fr/company/buzz_verb.ts
index 405efc3c..405efc3c 100644
--- a/src/locales/fr/company/bs_verb.ts
+++ b/src/locales/fr/company/buzz_verb.ts
diff --git a/src/locales/fr/company/index.ts b/src/locales/fr/company/index.ts
index 7875f08b..ad4d1c3b 100644
--- a/src/locales/fr/company/index.ts
+++ b/src/locales/fr/company/index.ts
@@ -4,9 +4,9 @@
  */
 import type { CompanyDefinitions } from '../../..';
 import adjective from './adjective';
-import bs_adjective from './bs_adjective';
-import bs_noun from './bs_noun';
-import bs_verb from './bs_verb';
+import buzz_adjective from './buzz_adjective';
+import buzz_noun from './buzz_noun';
+import buzz_verb from './buzz_verb';
 import descriptor from './descriptor';
 import name_patterns from './name_patterns';
 import noun from './noun';
@@ -14,9 +14,9 @@ import suffix from './suffix';
 
 const company: CompanyDefinitions = {
   adjective,
-  bs_adjective,
-  bs_noun,
-  bs_verb,
+  buzz_adjective,
+  buzz_noun,
+  buzz_verb,
   descriptor,
   name_patterns,
   noun,
diff --git a/src/locales/it/company/bs_adjective.ts b/src/locales/it/company/buzz_adjective.ts
index 05848292..05848292 100644
--- a/src/locales/it/company/bs_adjective.ts
+++ b/src/locales/it/company/buzz_adjective.ts
diff --git a/src/locales/it/company/bs_noun.ts b/src/locales/it/company/buzz_noun.ts
index 80898f42..80898f42 100644
--- a/src/locales/it/company/bs_noun.ts
+++ b/src/locales/it/company/buzz_noun.ts
diff --git a/src/locales/it/company/bs_verb.ts b/src/locales/it/company/buzz_verb.ts
index 8766ff1e..8766ff1e 100644
--- a/src/locales/it/company/bs_verb.ts
+++ b/src/locales/it/company/buzz_verb.ts
diff --git a/src/locales/it/company/index.ts b/src/locales/it/company/index.ts
index 7875f08b..ad4d1c3b 100644
--- a/src/locales/it/company/index.ts
+++ b/src/locales/it/company/index.ts
@@ -4,9 +4,9 @@
  */
 import type { CompanyDefinitions } from '../../..';
 import adjective from './adjective';
-import bs_adjective from './bs_adjective';
-import bs_noun from './bs_noun';
-import bs_verb from './bs_verb';
+import buzz_adjective from './buzz_adjective';
+import buzz_noun from './buzz_noun';
+import buzz_verb from './buzz_verb';
 import descriptor from './descriptor';
 import name_patterns from './name_patterns';
 import noun from './noun';
@@ -14,9 +14,9 @@ import suffix from './suffix';
 
 const company: CompanyDefinitions = {
   adjective,
-  bs_adjective,
-  bs_noun,
-  bs_verb,
+  buzz_adjective,
+  buzz_noun,
+  buzz_verb,
   descriptor,
   name_patterns,
   noun,
diff --git a/src/locales/pl/company/bs_adjective.ts b/src/locales/pl/company/buzz_adjective.ts
index 9fed1f1e..9fed1f1e 100644
--- a/src/locales/pl/company/bs_adjective.ts
+++ b/src/locales/pl/company/buzz_adjective.ts
diff --git a/src/locales/pl/company/bs_noun.ts b/src/locales/pl/company/buzz_noun.ts
index d0cd9f3f..d0cd9f3f 100644
--- a/src/locales/pl/company/bs_noun.ts
+++ b/src/locales/pl/company/buzz_noun.ts
diff --git a/src/locales/pl/company/bs_verb.ts b/src/locales/pl/company/buzz_verb.ts
index 405efc3c..405efc3c 100644
--- a/src/locales/pl/company/bs_verb.ts
+++ b/src/locales/pl/company/buzz_verb.ts
diff --git a/src/locales/pl/company/index.ts b/src/locales/pl/company/index.ts
index 7875f08b..ad4d1c3b 100644
--- a/src/locales/pl/company/index.ts
+++ b/src/locales/pl/company/index.ts
@@ -4,9 +4,9 @@
  */
 import type { CompanyDefinitions } from '../../..';
 import adjective from './adjective';
-import bs_adjective from './bs_adjective';
-import bs_noun from './bs_noun';
-import bs_verb from './bs_verb';
+import buzz_adjective from './buzz_adjective';
+import buzz_noun from './buzz_noun';
+import buzz_verb from './buzz_verb';
 import descriptor from './descriptor';
 import name_patterns from './name_patterns';
 import noun from './noun';
@@ -14,9 +14,9 @@ import suffix from './suffix';
 
 const company: CompanyDefinitions = {
   adjective,
-  bs_adjective,
-  bs_noun,
-  bs_verb,
+  buzz_adjective,
+  buzz_noun,
+  buzz_verb,
   descriptor,
   name_patterns,
   noun,
diff --git a/src/modules/company/index.ts b/src/modules/company/index.ts
index 467256c7..56c98050 100644
--- a/src/modules/company/index.ts
+++ b/src/modules/company/index.ts
@@ -78,7 +78,7 @@ export class CompanyModule {
   }
 
   /**
-   * Generates a random business catch phrase.
+   * Generates a random catch phrase that can be displayed to an end user.
    *
    * @example
    * faker.company.catchPhrase() // 'Upgradable systematic flexibility'
@@ -100,13 +100,33 @@ export class CompanyModule {
    * faker.company.bs() // 'cultivate synergistic e-markets'
    *
    * @since 2.0.1
+   *
+   * @deprecated Use `faker.company.buzzPhrase` instead.
    */
   bs(): string {
-    return [this.bsBuzz(), this.bsAdjective(), this.bsNoun()].join(' ');
+    deprecated({
+      deprecated: 'faker.company.bs',
+      proposed: 'faker.company.buzzPhrase',
+      since: '8.0',
+      until: '9.0',
+    });
+    return this.buzzPhrase();
+  }
+
+  /**
+   * Generates a random buzz phrase that can be used to demonstrate data being viewed by a manager.
+   *
+   * @example
+   * faker.company.buzzPhrase() // 'cultivate synergistic e-markets'
+   *
+   * @since 8.0.0
+   */
+  buzzPhrase(): string {
+    return [this.buzzVerb(), this.buzzAdjective(), this.buzzNoun()].join(' ');
   }
 
   /**
-   * Returns a random catch phrase adjective.
+   * Returns a random catch phrase adjective that can be displayed to an end user..
    *
    * @example
    * faker.company.catchPhraseAdjective() // 'Multi-tiered'
@@ -120,7 +140,7 @@ export class CompanyModule {
   }
 
   /**
-   * Returns a random catch phrase descriptor.
+   * Returns a random catch phrase descriptor that can be displayed to an end user..
    *
    * @example
    * faker.company.catchPhraseDescriptor() // 'composite'
@@ -134,7 +154,7 @@ export class CompanyModule {
   }
 
   /**
-   * Returns a random catch phrase noun.
+   * Returns a random catch phrase noun that can be displayed to an end user..
    *
    * @example
    * faker.company.catchPhraseNoun() // 'leverage'
@@ -152,10 +172,30 @@ export class CompanyModule {
    * faker.company.bsAdjective() // 'one-to-one'
    *
    * @since 2.0.1
+   *
+   * @deprecated Use `faker.company.buzzAdjective` instead.
    */
   bsAdjective(): string {
+    deprecated({
+      deprecated: 'faker.company.bsAdjective',
+      proposed: 'faker.company.buzzAdjective',
+      since: '8.0',
+      until: '9.0',
+    });
+    return this.buzzAdjective();
+  }
+
+  /**
+   * Returns a random buzz adjective that can be used to demonstrate data being viewed by a manager.
+   *
+   * @example
+   * faker.company.buzzAdjective() // 'one-to-one'
+   *
+   * @since 8.0.0
+   */
+  buzzAdjective(): string {
     return this.faker.helpers.arrayElement(
-      this.faker.definitions.company.bs_adjective
+      this.faker.definitions.company.buzz_adjective
     );
   }
 
@@ -166,10 +206,30 @@ export class CompanyModule {
    * faker.company.bsBuzz() // 'empower'
    *
    * @since 2.0.1
+   *
+   * @deprecated Use `faker.company.buzzVerb` instead.
    */
   bsBuzz(): string {
+    deprecated({
+      deprecated: 'faker.company.bsBuzz',
+      proposed: 'faker.company.buzzVerb',
+      since: '8.0',
+      until: '9.0',
+    });
+    return this.buzzVerb();
+  }
+
+  /**
+   * Returns a random buzz verb that can be used to demonstrate data being viewed by a manager.
+   *
+   * @example
+   * faker.company.buzzVerb() // 'empower'
+   *
+   * @since 8.0.0
+   */
+  buzzVerb(): string {
     return this.faker.helpers.arrayElement(
-      this.faker.definitions.company.bs_verb
+      this.faker.definitions.company.buzz_verb
     );
   }
 
@@ -180,10 +240,30 @@ export class CompanyModule {
    * faker.company.bsNoun() // 'paradigms'
    *
    * @since 2.0.1
+   *
+   * @deprecated Use `faker.company.buzzNoun` instead.
    */
   bsNoun(): string {
+    deprecated({
+      deprecated: 'faker.company.bsNoun',
+      proposed: 'faker.company.buzzNoun',
+      since: '8.0',
+      until: '9.0',
+    });
+    return this.buzzNoun();
+  }
+
+  /**
+   * Returns a random buzz noun that can be used to demonstrate data being viewed by a manager.
+   *
+   * @example
+   * faker.company.buzzNoun() // 'paradigms'
+   *
+   * @since 8.0.0
+   */
+  buzzNoun(): string {
     return this.faker.helpers.arrayElement(
-      this.faker.definitions.company.bs_noun
+      this.faker.definitions.company.buzz_noun
     );
   }
 }