We need some better documentation around timeouts. This email on the mailing list is a good place to start: https://groups.google.com/a/lists.datastax.com/d/msg/python-driver-user/zIAxfj_-OmM/aaAu1kyJ4DgJ
https://github.com/datastax/python-driver/commit/5dcc569c98a75c1746ea4adcb8c338e7c984540c