doc: adding migration notes for cm and cmi

This addresses #22 

Are there any other important notes worth mentioning?