updates to recent development changes

I made all the changes I could think of.

@hunpin please review, and note anything I may have missed.
@csherrard note I have included the changes you requested in http://jira.mygazoo.com/browse/OP-5108 to these doc updates.
I have not yet started on OP-5108, but I should get to it Monday.