more doc cleanup (see diff)