Document uses for map

This adds documentation to `map` on a couple of common uses. One is
using a different implementation of a common API. The other is ignoring
an optional dependency. Closes #283
Merge pull request #285 from bitovi/map-docs

Document uses for map