added docs for #2857