fixes #258
added state model to documentation - this addresses #251
merge from devel