docs for #update