doc updates from pairing with Bob