Demonstrate -flattenMap: effects in the documentation

Addresses #336.

CC @dmitrym0 @alanjrogers