update docs for #480