diff --git a/README.md b/README.md
index aaf931d..0bb9870 100644
--- a/README.md
+++ b/README.md
@@ -9,3 +9,16 @@ Turns "LastName, FirstName" into "FirstName LastName"
  * Calling 'reaarange_name("Turing, Alan")' will return '"Alan Turing"'
  * Calling 'reaarange_name("Hopper, Grace M.")' will return '"Grace M. Hopper"'
  * Calling 'reaarange_name("Voltaire")' will return '"Voltaire"'
+ 
+Rearrange
+=========
+
+This module is used for rearranging names.
+Turns "LastName, FirstName" into "FirstName LastName"
+
+## Example
+
+ * Calling 'reaarange_name("Turing, Alan")' will return '"Alan Turing"'
+ * Calling 'reaarange_name("Hopper, Grace M.")' will return '"Grace M. Hopper"'
+ * Calling 'reaarange_name("Voltaire")' will return '"Voltaire"'
+