add few notes pertaining to recent changes