some doco updates