code cleanup
Update README.md

added comments for state management
Update README.md
Update README.md
Merge branch 'master' into develop