Add User Guide entry, Examples and minor corrections to the docstring.