update change log and readme.md based on PR review feedback