more doco improvements