Update README.md

@jashkenas I've updated README.md as a replacement for the bare README, and removed rdoc spec from gemspec, replacing the extra_rdoc_files by .yardopts (I copied this from the gem folks so I presume they know what they are doing). Currently all these changes only exist in the monkstone "branch" which isn't actually a branch, but contains all the history apart from the binaries.