some rudimentary documentation
update todos