update docs, set timeouts, failure messages