doco and other updates