Update documentation

- Add "common issues" section to README
- Add more inline documentation to examples
Merge pull request #31 from box/update-docs

Update documentation