docs: add migration/compat basics