add a module level docstring and doctest skips where appropriate