some helpful doc updates