added documentation for update parameter