more docs polish