document `update` as well?