Fixes 16928, improve reflections public API doc

two things in here,
- Add changelog entry for reflections API change
- Fix public doc for `reflections` method.

review @rafaelfranca @matthewd