update comments & export useful bits
update docs