fix example
fix docstrings and tiny improvements