update docs for #619