Document Timeout behaviour
s/behavior/behaviour
tildes
Merge pull request #2187 from kevinburke/more-docs

Document Timeout behaviour