Add documentation on altering states.

@thatch45 how is this?

@basepi how do you do references to other doc/ref/states files?