add api documentation

merry christmas, this prefaces the diatribe in the readme with api documentation