Readme updates

I was reading through it anyways, so I thought I might do some editing.  Mostly because that first line bugged me :)

I also realized halfway through that these docs are probably for the heroku page, and that heroku probably has some special markdown syntax.  Feel free to trash this if it breaks things.