feedback from @jaredkerim
update docs