adding some notes for an update/migration functions