ENH: examples for release notes and fix up nested dict example and test

fix up rough edges of docs and add a more thorough test for nested dicts

fix unintended example