[docs] Update README

1 files changed, 13 insertions, 0 deletions

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