README.md in cat_ipsum-0.2.1 vs README.md in cat_ipsum-0.2.2

@@ -30,9 +30,27 @@
 # => "Shake treat bag, chase imaginary bugs, why must they do that. Nap all day, stand in doorway, yawn so much. Play time, chew ipad power cord, ignore the human. Need to chase tail, hide when guests come over, throwup on your pillow. Hate dog, mark territory, go crazy"
 ```
 
 `CatIpsum.sentences` and `CatIpsum.paragraphs` returns arrays of their original methods.
 
+All of the methods could take integer parameter to configure count of sentence parts or elements in array.
+Some examples:
+
+```ruby
+CatIpsum.sentence(1)
+# => "Stand in front of the computer screen."
+
+CatIpsum.sentence(2)
+# => "Get on the high shelf, swat at dog."
+
+CatIpsum.sentences(1)
+#=> ["Play time, stretch, need to chase tail."]
+
+CatIpsum.sentences(2)
+#=> ["Sleep on keyboard, intently stare at the same spot, sweet beast.", "Intrigued by the shower, rub face on everything, burrow under covers."]
+
+```
+
 `CatIpsum.phrase` and `CatIpsum.phrases` are aliases to `CatIpsum.sentence` and `CatIpsum.sentence`.
 
 #### Working with randomizing seeds
 
 You can specify your seed to generate repeatable data. Also, seed can be reseted by `CatIpsum.reset!` method.