Update documentation

Readme and JSDoc strings updated to align with code and latest state of
Orca project.
Merge pull request #1 from sharpie7/master

Update documentation - merged as no negative comments received in review period.