Alignment updates and JSDoc improvements

The Orca.js API definition is updated to align to the stub and reflector implementations. The aligned behaviour also seems to follow common practice in other APIs.

Editorial and layout improvements are made to the README and JSDoc contents.