DOCS-2110 DOCS-2345 tweaks to update method