Tweak things.

* Remove doc/README.md symlink
* Simplify YARDopts
* Update gems
* Documentation!