Because there are many breaking changes an upgrade is not that easy. There are many edge cases this guide does not cover. PRs are welcome to improve this guide.
Library completely rewritten with too many breaking changes to list. Check README for details.