This moves the documentation out of "Basic Usage" and expands on some of
the caveats of this approach.