Update ModelResponse.js

lib/response/ModelResponse.js

@@ -41,6 +41,34 @@ ModelResponse.prototype.mixin = function mixin() {
     });
 };
 
+/**
+ * Converts the data format of the data in a JSONGraph Model response to a stream of path values.
+ * @name toPathValues
+ * @memberof ModelResponse.prototype
+ * @function 
+ * @return ModelResponse.<PathValue>
+ * @example
+var model = new falcor.Model({
+  cache: {
+    user: {
+      name: "Steve",
+      surname: "McGuire"			
+    }
+  }
+});
+
+model.
+  get(["user",["name", "surname"]]).
+  toPathValues().
+  // this method will be called twice, once with the result of ["user", "name"]
+  // and once with the result of ["user", "surname"]
+  subscribe(function(pathValue){
+    console.log(JSON.stringify(pathValue));
+  });
+// prints...
+"{\"path\":[\"user\",\"name\"],\"value\":\"Steve\"}"
+"{\"path\":[\"user\",\"surname\"],\"value\":\"McGuire\"}"
+ */
 ModelResponse.prototype.toPathValues = function toPathValues() {
     return this.mixin(valuesMixin).asObservable();
 };