[Docs] Update addons.update

Fixes #1815.
Add the new `$apply` command, plus a few examples.

@petehunt
(I am not a huge fan generally of non-homogeneous arrays…)