[WIP] Improving timeout behavior and documentation

See #392 
options