added one more desired feature to the state module. cleaned the
documentation a little to try and make it a little more salty.