Adding javadoc to UpdateRequestBuilder for a couple of details 

Closes #4904 (this PR is nothing more than a squashed single-commit version of #4904).