further docs improvements