update and fix many docs