updating readme with clearer function lists and sections, and mocha test example