Improved comments and README.md