Better docs

Too verbose? @csfrancis 

Added myself as coauthor for efame. Can you add me on rubygems as well so I can release the gem so you're not a SPOF?
you would know with your linkedin endorsements!