Improve docs on create_batch (Closes #139).

1 files changed, 10 insertions, 0 deletions

diff --git a/README.rst b/README.rst
index b4ba689..0ba4a86 100644
--- a/README.rst
+++ b/README.rst
@@ -155,6 +155,16 @@ No matter which strategy is used, it's possible to override the defined attribut
     "Joe"
 
 
+It is also possible to create a bunch of objects in a single call:
+
+.. code-block:: pycon
+
+    >>> users = USerFactory.build(10, first_name="Joe")
+    >>> len(users)
+    10
+    >>> [user.first_name for user in users]
+    ["Joe", "Joe", "Joe", "Joe", "Joe", "Joe", "Joe", "Joe", "Joe", "Joe"]
+
 Lazy Attributes
 """""""""""""""