updated api docs as part of #14

see #14