adding example API use, docstring edits