add some extra docstring notes