Add a migration guide

Motivation:

Moving from 1.x to 2.x isn't trivial. We should provide a guide for
doing this.

Modifications:

- Add a guide for migrating client code and services
- Add a script which can automate parts of this

Result:

Some guidance on migrating.

Author: glbrntt