updated user documentation and updated example