modifying docs to include migration info