DOCS-1077 add missing multi parameter to update examples

and some copy edits (mainly reordering the sentences)