[docs] Updating README

1 files changed, 7 insertions, 5 deletions

diff --git a/Readme.md b/Readme.md
index 247cc8c5..8d107cd4 100644
--- a/Readme.md
+++ b/Readme.md
@@ -31,19 +31,21 @@
 
 ## API
 
-## Faker.fake() Generator
+### Faker.fake()
 
-As of version `v3.0.0` faker.js contains a super useful generator method for combining faker methods using a mustache string format.
+As of version `v3.0.0` faker.js contains a super useful generator method `Faker.fake` for combining faker API methods using a mustache string format.
 
-Example:
+**Example:**
 
-```js
-console.log(faker.fake(',  '));
+``` 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 Methods
+
 * address
   * zipCode
   * city