diff --git a/readme.md b/readme.md
index a4f5c3b03..bc9f83171 100644
--- a/readme.md
+++ b/readme.md
@@ -239,22 +239,24 @@ Each of the generator properties (like `name`, `address`, and `lorem`) are calle
     ean13          // '4006381333931'
     ean8           // '73513537'
     isbn13         // '9790404436093'
-    isbn10         // '4881416324
+    isbn10         // '4881416324'
 
 ### `Faker\Provider\Miscellaneous`
 
     boolean($chanceOfGettingTrue = 50) // true
-    md5                     // 'de99a620c50f2990e87144735cd357e7'
-    sha1                    // 'f08e7f04ca1a413807ebc47551a40a20a0b4de5c'
-    sha256                  // '0061e4c60dac5c1d82db0135a42e00c89ae3a333e7c26485321f24348c7e98a5'
-    locale                  // en_UK
-    countryCode             // UK
-    languageCode            // en
-    currencyCode            // EUR
+    md5           // 'de99a620c50f2990e87144735cd357e7'
+    sha1          // 'f08e7f04ca1a413807ebc47551a40a20a0b4de5c'
+    sha256        // '0061e4c60dac5c1d82db0135a42e00c89ae3a333e7c26485321f24348c7e98a5'
+    locale        // en_UK
+    countryCode   // UK
+    languageCode  // en
+    currencyCode  // EUR
 
 ### `Faker\Provider\Biased`
 
-    biasedNumberBetween($min, $max, $function) // 42
+    // get a random number between 10 and 20,
+    // with more chances to be close to 20
+    biasedNumberBetween($min = 10, $max = 20, $function = 'sqrt')
 
 ## Unique and Optional modifiers