DOCS-916: corrections and additional admonitions