Comments on design doc

I've put in some comments, in *italics* and tagged [colin], mostly around harmonizing the design of this SDK with the design of our two clearest existing SDKs - JavaScript and Unity.