docs: update migration guide (#10930)