Document migrations as a legacy feature, and tidy those docs#3348

hyanwong merged 1 commit intotskit-dev:maintskit-dev/tskit:mainfrom

hyanwong:migrations-clarificationhyanwong/tskit:migrations-clarificationCopy head branch name to clipboard