improve README and code documentation
Merge pull request #8 from groovecoder/improve-README

improve README and code documentation