Update documentation

Quite a few commits here, but I tried to break them up pretty well.

I'm also going to be making a branch (starting from here) that will bring compatibility with ruby 1.8.7 (yeah, I know) for an immediate need. I'd expect that branch to wither and die in a few months.