docs: add a 3.0 migration guide

things like #300 will require users to "migrate" their history. hilbish could also do this automatically. either way, 3.0 *will* have breaking changes and documenting how users can resolve any issues from upgrading would be good.