Doc fixes

Fixes https://github.com/balanced/balanced-docs/issues/421
https://github.com/balanced/balanced-docs/issues/448

And adds PR for rev1.1 migration python
this block of code should be a separate method.