more doco upates