doc updates, passes checks