docs(api): write a migration guide for the 4.0 release

[kszucs]

The 4.x.x branch contains breaking changes, so we should make a migration guide for both the downstream backend implementors and users. Though the latter may not be required since the user facing API don't change, just the internals.