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?