Merge pull request #321 from djarecka/doc/state_upd

[doc] expanding the State's docstrings, small cleaning

Author: djarecka