updated readme with some more persistent state docs