- changelog update for 1.0.17

- note issue

- fix a changelog issue

- fix version

- update doc

- prep for release

we want the new value returned, not in-place

- version bump for fix

- fix typo

- style fixes