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
Merge pull request #3639 from cpcloud/replace-with-regex-2285

single example for release notes