Add very basic documentation for the revealed libraries
Clarifications in the README
Merge pull request #1 from chaucerbao/feature/documentation

Add minimal documentation on the library functions