Docs: clarify state mutation and add example

Docs: clarify state mutation and add example #462