api docs fleshed out some more