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.

This also adds a test for the scenario where map is used to ignore a dependency.

Closes #283