Mostly documentation improvements

As I am integrating horus into another web app, I took the chance to make the README a little more detailed. I noticed several things that setup.py could be doing better, so I fixed them, too.