📝 Add even more comments

src/FireEffect.js

@@ -30,15 +30,21 @@ const utils          = Me.imports.src.utils;
 // The shader class for this effect is registered further down in this file.
 let FireShader = null;
 
+// The effect class is completely static. It can be used to get some metadata (like the
+// effect's name or supported GNOME Shell versions), to initialize the respective page of
+// the settings dialog, as well as to create the actual shader for the effect.
 var FireEffect = class FireEffect {
 
-  // ---------------------------------------------------------------------- static methods
+  // ---------------------------------------------------------------------------- metadata
 
   // The effect is available on all GNOME Shell versions supported by this extension.
   static getMinShellVersion() {
     return [3, 36];
   }
 
+  // This will be called in various places where a unique identifier for this effect is
+  // required. It should match the prefix of the settings keys which store whether the
+  // effect is enabled currently (e.g. the '*-close-effect').
   static getNick() {
     return 'fire';
   }
@@ -49,6 +55,9 @@ var FireEffect = class FireEffect {
     return 'Fire';
   }
 
+  // -------------------------------------------------------------------- API for prefs.js
+
+  // This is called by the preferences dialog.
   static initPreferences(dialog) {
 
     // Add the settings page to the builder.
@@ -85,6 +94,9 @@ var FireEffect = class FireEffect {
         FireEffect.getLabel());
   }
 
+  // ---------------------------------------------------------------- API for extension.js
+
+
   static createShader(settings) {
     return new FireShader(settings);
   }