add note in docs for #692