more all docs improvements