[docs] Update README

2 files changed, 36 insertions, 0 deletions

diff --git a/Readme.md b/Readme.md
index f1d1bc24..247cc8c5 100644
--- a/Readme.md
+++ b/Readme.md
@@ -31,6 +31,19 @@
 
 ## API
 
+## Faker.fake() Generator
+
+As of version `v3.0.0` faker.js contains a super useful generator method for combining faker methods using a mustache string format.
+
+Example:
+
+```js
+console.log(faker.fake(',  '));
+// outputs: "Marks, Dean Sr."
+```
+
+This will interpolate the format string with the value of methods `name.lastName()`, `name.firstName()`, and `name.suffix()`
+
 * address
   * zipCode
   * city
@@ -48,6 +61,16 @@
   * stateAbbr
   * latitude
   * longitude
+* commerce
+  * color
+  * department
+  * productName
+  * price
+  * categories
+  * mergeCategories
+  * productAdjective
+  * productMaterial
+  * product
 * company
   * suffixes
   * companyName
diff --git a/build/src/docs.md b/build/src/docs.md
index 4f5aa7c0..6f5c3438 100644
--- a/build/src/docs.md
+++ b/build/src/docs.md
@@ -31,6 +31,19 @@
 
 ## API
 
+## Faker.fake() Generator
+
+As of version `v3.0.0` faker.js contains a super useful generator method for combining faker methods using a mustache string format.
+
+Example:
+
+```js
+console.log(faker.fake('{{name.lastName}}, {{name.firstName}} {{name.suffix}}'));
+// outputs: "Marks, Dean Sr."
+```
+
+This will interpolate the format string with the value of methods `name.lastName()`, `name.firstName()`, and `name.suffix()`
+
 {{{API}}}
 
 ## Localization