Improve docs

[sfcgeorge]

The docs are better than they look on RubyDoc.info because we use a custom plugin that simply isn't run on RubyDoc. I need to get that plugin installed on the RubyDoc servers for the docs to look better. For now though you can run yard locally and get the good docs.