Add better documentation, more errors, default timeout

[mrashed-dev]

Description

This PR adds an upgrade doc, updates the readme, adds more error classes and a default timeout.

License

I confirm that this contribution is made under the terms of the MIT license and that I have the authority necessary to make this contribution on behalf of its copyright owner.