added short README that points to the blog
cleaned up and documented a bit for easier human parsing
cleaned up and documented a bit for easier human parsing