add api documentation

merry christmas, this prefaces the diatribe in the readme with api documentation

```
 ####################""N########NN#####################################D.H.
 ################N@" _, #######F  0########################################
 ###############@" _g# j#@FN#@ _  0########################################
 #############NF _g##F 0" _ " j# j#########################################
 #############F g#### - _g   g@ q####@" "N##F""9N##N"P"N###@"3#@"0#########
 #############NJ####   g#"  d@  0###F g@ g#P _  0##' , j##@ j0# j##########
 ##################"  d#F  0#  J###" +"_d#@ J" g##F 0  0##  ##  0##########
 ################NF _0#@ _0## j##NF  _g##F gF j#N"_A  0##  0#  J###########
 ###############N" _0#@  d##  0N@"  d##@"_d# qNF _#F J@"   @  jPT##########
 ###############F _0##_ d###p ""_g#_`""_g###p  jg###_ _g0k _p F_A##########
 ################g#####N#####pgg####Ngg######NN#####NNN###N#  j############
 ##########################################################  j#############
 ######N@" "N#####NN######################################F j##############
 ####NF  ___ ##### j######################################L 0##############
 ###@   gN# j###@ j#############@"N########################N###############
 ##F  a0"jF d##N" ###############g0#########" B############################
 #F  j##   j###F N######NNNN####N#####F"2NNF dN###N#####N@0#####@@N#####@""
 #  j###pgg###@ g@""###@    ###F J###" j#E, ,_0#@ j@""0@  j##N@"_, j###@  d
 F  #########@     d##@ jF J##F j### j d##' 0##@   _f ", j###  g#  ###@ p #
 F j########P   d j##@ jF j##@ j##@ gP 0#F j##P   d@  g' ###  0#  d##F d  #
 # 3#####@F   _#F 0N@ g@ j##"  0N@  #  N"  N#"_ _0# _0# jN@  g#" j#@" t@ j@
 #L_""""" _g" 0#_ P"_d#& 9" ap F"_p " ` arJ@ a' 0# _0## ?"__ " j_`F g_ ' "_
 ##Np___gg##pg###_jg####L_g0##__g##p_ag0##_jg#Ld##m0###p_g##p_g##_a0##__gg#

```