Demonstrate -flattenMap: effects in the documentation

Addresses #336.

@dmitrym0 @alanjrogers