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