We should clearly explain all syntax options and nature of state update (shallow vs. recursive merge).