added state model to documentation - this addresses #251