More documentation to Admin Controllers

app/assets/javascripts/admin/controllers/admin_flags_controller.js

@@ -10,6 +10,12 @@
   **/ 
   window.Discourse.AdminFlagsController = Ember.Controller.extend({
     
+    /**
+      Clear all flags on a post
+
+      @method clearFlags
+      @param {Discourse.FlaggedPost} item The post whose flags we want to clear
+    **/
     clearFlags: function(item) {
       var _this = this;
       item.clearFlags().then((function() {
@@ -19,6 +25,12 @@
       }));
     },
 
+    /**
+      Deletes a post
+
+      @method deletePost
+      @param {Discourse.FlaggedPost} item The post to delete
+    **/
     deletePost: function(item) {
       var _this = this;
       item.deletePost().then((function() {
@@ -28,10 +40,20 @@
       }));
     },
 
+    /**
+      Are we viewing the 'old' view?
+
+      @property adminOldFlagsView
+    **/
     adminOldFlagsView: (function() {
       return this.query === 'old';
     }).property('query'),
 
+    /**
+      Are we viewing the 'active' view?
+
+      @property adminActiveFlagsView
+    **/
     adminActiveFlagsView: (function() {
       return this.query === 'active';
     }).property('query')