some docs improvements