add docs for #492