minor fixes & documentation improvments