further doc updates