documentation and tweaks on testing