Add documentation about update handlers

Adding documentation which was missing previously. Also mention a warning about the following issue:

https://github.com/flatiron/cradle/issues/270