A bit of extra javadoc for updates

Adding javadoc to UpdateRequestBuilder for a couple of details it took me a while to find.