update changelog according to code review feedback