Description at the top of the file

README.md

@@ -1,18 +1,30 @@
 Shreddit
 ========
 
+Description
+-----------
+Shreddit is a Python command line program which will take a user's post history
+on the website [Reddit](http://reddit.com), and will systematically go through
+the user's history deleting one post/submission at a time until only those
+whitelisted remain.
+
+**Note:** When it became known that post edits were *not* saved but post
+deletions *were* saved, code was added to edit your post prior to deletion. In
+fact you can actually turn off deletion all together and just have lorem ipsum
+(or a message about Shreddit) but this will increase how long it takes the
+script to run as it will be going over all of your messages every run!
+
+It allows you to maintain your normal reddit account while having your history
+scrubbed after a certain amount of time.
+
 User Login deprecation
 ----------------------
-
 Reddit intends to disable username-password based authentication to access its
 APIs in the near future. You can specify your username and password in the
 `shreddit.yml` or the `praw.ini` to make it work **FOR NOW**. But consider
 looking at the [OAuth2 instructions](#oauth2-instructions) if you intend to use
 this program in the future.
 
-Description
------------
-
 Shreddit is a Python command line program which will take a user's post history
 on the website [Reddit](http://reddit.com), and will systematically go through
 the user's history deleting one post/submission at a time until only those