many more comprehensive doc updates