DOCS-929: corrections to introduction from discussion with paul