Add update() docs
Merge pull request #1155 from petehunt/update-helper

Add update() docs
[docs] Fix version in lifecycle argument note

Fixes #1163.