docstrings and online demo updated