example updated; docstrings markup fix; typo in docs;