added docs for `consume`