docs; add note to model.update

closes #571