add example in docstrings