more docs improvements