refactoring of the function call and example to the docs
requested review from @fima
assigned to @fima
approved this merge request
merged
mentioned in commit 9a4455ca