UI, history: doc updates

client/galaxy/scripts/mvc/collection/collection-li.js

@@ -33,10 +33,13 @@ var DCListItemView = FoldoutListItemView.extend(
     /** event listeners */
     _setUpListeners : function(){
         FoldoutListItemView.prototype._setUpListeners.call( this );
-        // re-rendering on deletion
         this.listenTo( this.model, 'change', function( model, options ){
+            // if the model has changed deletion status render it entirely
             if( _.has( model.changed, 'deleted' ) ){
                 this.render();
+
+            // if the model has been decorated after the fact with the element count,
+            // render the subtitle where the count is displayed
             } else if( _.has( model.changed, 'element_count' ) ){
                 this.$( '> .title-bar .subtitle' ).replaceWith( this._renderSubtitle() );
             }

client/galaxy/scripts/mvc/history/history-contents.js

@@ -205,7 +205,7 @@ var HistoryContents = Backbone.Collection
         return this.fetch( options );
     },
 
-    /**  */
+    /** specialty fetch method for retrieving the element_counts of all hdcas in the history */
     fetchCollectionCounts : function( options ){
         options = options || {};
         options.data = _.defaults({