diff --git a/docs/usage.rst b/docs/usage.rst
new file mode 100644
index 0000000000000000000000000000000000000000..16b528a0c231d2f34e3396a432c2b1cfffbf6ae1
--- /dev/null
+++ b/docs/usage.rst
@@ -0,0 +1,152 @@
+Usage
+=====
+
+Pydenticon provides simple and straightforward interface for setting-up the
+identicon generator, and for generating the identicons.
+
+Instantiating a generator
+-------------------------
+
+The starting point is to create a generator instance. Generator implements
+interface that can be used for generating the identicons.
+
+In its simplest form, the generator instances needs to be passed only the size
+of identicon in blocks (first parameter is width, second is height)::
+
+  # Import the library.
+  import pydenticon
+
+  # Instantiate a generator that will create 5x5 block identicons.
+  generator = pydenticon.Generator(5, 5)
+
+The above example will instantiate a generator that can be used for producing
+identicons which are 5x5 blocks in size, using the default values for digest
+(*MD5*), foreground colour (*black*), and background colour (*white*).
+
+Alternatively, you may choose to pass in a different digest algorithm, and
+foreground and background colours::
+
+  # Import the libraries.
+  import pydenticon
+  import hashlib
+
+  # Set-up a list of foreground colours (taken from Sigil).
+  foreground = [ "rgb(45,79,255)",
+                 "rgb(254,180,44)",
+                 "rgb(226,121,234)",
+                 "rgb(30,179,253)",
+                 "rgb(232,77,65)",
+                 "rgb(49,203,115)",
+                 "rgb(141,69,170)" ] 
+
+  # Set-up a background colour (taken from Sigil).
+  background = "rgb(224,224,224)"
+
+  # Instantiate a generator that will create 5x5 block identicons using SHA1
+  # digest.
+  generator = pydenticon.Generator(5, 5, digest=hashlib.sha1,
+                                   foreground=foreground, background=background)
+
+Generating identicons
+---------------------
+
+With generator initialised, it's now possible to use it to create the
+identicons.
+
+The most basic example would be creating an identicon using default padding (no
+padding) and output format ("png"), without inverting the colours (which is also
+the default)::
+
+  # Generate a 240x240 PNG identicon.
+  identicon = generator.generate("john.doe@example.com", 240, 240)
+
+The result of the ``generate()`` method will be a raw representation of an
+identicon image in requested format that can be written-out to file, sent back
+as an HTTP response etc.
+
+Usually it can be nice to have some padding around the generated identicon in
+order to make it stand-out better, or maybe to invert the colours. This can be
+done with::
+
+  # Set-up the padding (top, bottom, left, right) in pixels.
+  padding = (20, 20, 20, 20)
+
+  # Generate a 200x200 identicon with padding around it, and invert the
+  # background/foreground colours.
+  identicon = generator.generate("john.doe@example.com", 200, 200,
+                                 padding=padding, inverted=True)
+
+Finally, the resulting identicons can be in different formats::
+
+  # Create identicon in PNG format.
+  identicon_png = generator.generate("john.doe@example.com", 200, 200,
+                                     output_format="png")
+  # Create identicon in ASCII format.
+  identicon_ascii = generator.generate("john.doe@example.com", 200, 200,
+                                       output_format="png")
+
+Using the generated identicons
+------------------------------
+
+Of course, just generating the identicons is not that fun. They usually need
+either to be stored somewhere on disk, or maybe streamed back to the user via
+HTTP response. Since the generate function returns raw data, this is quite easy
+to achieve::
+
+  # Generate same identicon in two different formats.
+  identicon_png = generator.generate("john.doe@example.com", 200, 200,
+                                     output_format="png")
+  identicon_ascii = generator.generate("john.doe@example.com", 200, 200,
+                                       output_format="png")
+
+  # Identicon can be easily saved to a file.
+  f = open("sample.png", "w")
+  f.write(identicon_png)
+  f.close()
+
+  # ASCII identicon can be printed-out to console directly.
+  print identicon_ascii
+
+Full example
+------------
+
+Finally, here is a full example that will create a number of identicons and
+output them in PNG format to local directory::
+
+  #!/usr/bin/env python
+
+  # Import the libraries.
+  import pydenticon
+  import hashlib
+
+  # Set-up some test data.
+  users = ["alice", "bob", "eve", "dave"]
+
+  # Set-up a list of foreground colours (taken from Sigil).
+  foreground = [ "rgb(45,79,255)",
+                 "rgb(254,180,44)",
+                 "rgb(226,121,234)",
+                 "rgb(30,179,253)",
+                 "rgb(232,77,65)",
+                 "rgb(49,203,115)",
+                 "rgb(141,69,170)" ] 
+
+  # Set-up a background colour (taken from Sigil).
+  background = "rgb(224,224,224)"
+
+  # Set-up the padding (top, bottom, left, right) in pixels.
+  padding = (20, 20, 20, 20)
+
+  # Instantiate a generator that will create 5x5 block identicons using SHA1
+  # digest.
+  generator = pydenticon.Generator(5, 5, foreground=foreground,
+                                   background=background)
+
+  for user in users:
+    identicon = generator.generate(user, 200, 200, padding=padding,
+                                   output_format="png")
+
+    filename = user + ".png"
+    with open(filename, "w") as f:
+        f.write(identicon)
+