check if this is valid rst for doc build
then add to other docstrings