clarified docs some more