I should really add more documentation for explanations. This will have the happy side effect of increasing test coverage (via doctest)