Update by() doc