add a little more doc about custom push methods