docs(guide/migration): add migration guide
chore(docs): allow periods in doc shortNames