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

Add update() docs