adding some more docs to fs-model
convenience methods for updating persona references
enhancement constructors to the states that are supported as entry points