moar documentation!  trying to get full pod coverage for all methods.  getting closer