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?
s/Semian::Timeout/Semian::TimeoutError/