docs improvements