add notes about things to migrate to common code