adding contributors key to package.json
adding Usage and API sections to readme; updating examples