BaseReviewResource.update_review() takes several important arguments,

which weren't previously documented. This is a simple change that

documents the function a bit better, adding information on the arguments

and return type.

Unit tests passed.