updated comments and README.md