code comment updates

lib/edit/editsStore.js

@@ -66,11 +66,23 @@ O.esri.Edit.EditStore = function()
      *
      * Handles both adds and updates. It copies any object properties, so it will not, by default, overwrite the entire object.
      *
-     * Example: If you just submit {featureLayerRenderer: {someJSON}} it will only update the featureLayerRenderer property
+     * Example 1: If you just submit {featureLayerRenderer: {someJSON}} it will only update the featureLayerRenderer property
+     * Example 2: This is a full example
+     * {
+     *      featureLayerJSON: ...,
+     *      featureLayerGraphicsSerialized: ...,
+     *      renderer: ...,
+     *      opacity: ...,
+     *      outfields: ...,
+     *      mode: ...,
+     *      extent: ...,
+     *      zoom: 7,
+     *      lastEdit: ...
+     * }
      *
      * NOTE: "dataObject.id" is a reserved property. If you use "id" in your object this method will break.
      * @param dataObject Object
-     * @param callback callback(true, null) || callback(false, error)
+     * @param callback callback(true, null) or callback(false, error)
      */
     this.pushFeatureLayerJSON = function(dataObject /*Object*/, callback){
 
@@ -88,6 +100,7 @@ O.esri.Edit.EditStore = function()
 
                 var objectStore = db.transaction([objectStoreName],"readwrite").objectStore(objectStoreName);
 
+                // Make a copy of the object
                 for(var key in dataObject){
                     if (dataObject.hasOwnProperty(key)) {
                         result[key] = dataObject[key];
@@ -797,6 +810,7 @@ O.esri.Edit.EditStore = function()
 
     /**
      * Returns the approximate size of the database in bytes
+     * IMPORTANT: Currently requires all data be serialized!
      * @param callback  {usage, error} Whereas, the usage Object is {sizeBytes: number, editCount: number}
      */
     this.getUsage = function(callback)