Can't agree more @Lynn 🙂 Will give it a shot. A lot of the finer aspects of CosmosDB (or DocDB as we call it) stuff is not documented yet, probably because the product is evolving fast.

@steve-2: I get an error on clicking the link. Error message is:
The page requested could not be found. If the problem continues, contact the board administrator.