0.3.7 to 1.0.0-alpha migration docs

I'd like there to be prose form documentation on the things we changed in the public API, why we did them, and how to migrate legacy codebases to the new API.