Attempt to document persistence behavior. 

My understanding of how persistence works here has been documented. It needs a peer-review.
Merge pull request #8 from markstos/master

resolve #7 : document persistence behavior.