document api stuff
missing bracket
logging fixes
the other guys