Update documentation for the new driver

[fnrcum]

Is your feature request related to a problem? Please describe.
I have been checking the documentation on the python driver and frankly it's old. I've also tried using the ConnectionPool feature but i'm having a hard time doing so. The example is not really concise and the documentation does not have this.
Also I use PyCharm as an IDE and most of the time it tells me certain things like r.table_create() and such are not available

Describe the solution you'd like
Updating the documentation to reflect the changes would be nice with some actual practical examples.

Additional context
I'm also migrating from the 2.3.x driver and the transition in a big application is painful without proper docs

[gabor-boros]

@fnrcum Sorry for the late reply. Having busy days.

Do you refer to the rethinkdb.com documentation?