Timeout workflow is not well-documented

[csuhta]

I only recently started using this gem, and the documentation on how to handle request timeouts isn't very clear. I'm happy to update the wiki but I wanted to make sure this is correct:

If you are using HTTP.timeout(10).get(…) is the proper workflow to catch the HTTP::Timeout exception? Or is HTTP::Timeout only raised in default/internal code circumstances?

https://github.com/httprb/http/wiki/Timeouts

[uberllama]

I'd love to see some illumination on this, particularly as regards thread safety.