doco improvements