added documentation for class state