Migration docs and touches (#23)

* Add new migration docs to help `v1.x` users migrate to the new
`v2.x` SDK
* Make some final touches in the client wrapper to be similar to the
Python one
* Add link to the migration guide in the README file

Author: jverce