diff --git a/README b/README
new file mode 100755
index 0000000..b6fadc6
--- /dev/null
+++ b/README
@@ -0,0 +1,14 @@
+Add a task to taskwarrior via email. Makes use of the taskw Python bindings.
+
+ http://taskwarrior.org
+ https://github.com/ralphbean/taskw
+
+For use with procmail or maildrop. Example using maildrop's .mailfilter:
+
+
+  if ($SIZE < 8192 && /^From:.*myaddress@example.com/ && /^To:.*taskwarrior@/)
+  {
+    log "add task via mail2taskwarrior"
+    xfilter "devel/mail2taskwarrior/mail2taskwarrior"
+    exit
+  }
diff --git a/mail2taskwarrior b/mail2taskwarrior
index 15a0b9e..bd107f4 100755
--- a/mail2taskwarrior
+++ b/mail2taskwarrior
@@ -5,15 +5,7 @@
 # http://taskwarrior.org
 # https://github.com/ralphbean/taskw
 #
-# For use with procmail or maildrop. Example using maildrop's .mailfilter:
-#
-#
-#  if ($SIZE < 8192 && /^From:.*myaddress@example.com/ && /^To:.*taskwarrior@/)
-#  {
-#    log "add task via mail2taskwarrior"
-#    xfilter "devel/mail2taskwarrior/mail2taskwarrior"
-#    exit
-#  }
+# See README for more info.
 #
 
 from taskw import TaskWarrior