Migration guide
Write a guide that moves a user from the old version to the new version.
- List each breaking change between the two versions.
- For each breaking change, show the old code and the new code side by side.
- Give the steps in the order that the user must do them.
- Say how the user can check that the upgrade worked.
- Say which deprecated behavior still works, and in which version it will be removed.