[glenjamin]

It's not even just documentation - you can use it like visual unit tests, so you can see what the effects of a change are to all the different states of a component.