add some comments

lib/searchyou/generator.rb

@@ -6,33 +6,43 @@ class Generator < Jekyll::Generator
     safe true
     priority :lowest
 
-    def self.abort(msg)
-      $stderr.puts(msg)
-    end
+    # Public: Invoked by Jekyll during the generation phase.
+    def generate(site)
 
-    def self.elasticsearch_url(site)
-      ENV['ELASTICSEARCH_URL'] ||
-      ENV['BONSAI_URL'] ||
-      ((site.config||{})['elasticsearch']||{})['url'] ||
-      raise(ArgumentError, "No Elasticsearch URL present, skipping indexing")
-    end
+      # Find the ES URL
+      url = elasticsearch_url(site)
 
-    def generate(site)
-      url = self.class.elasticsearch_url(site)
+      # Prepare the indexer
       indexer = Searchyou::Indexer.new(site)
       indexer.start
 
+      # Iterate through the site contents and send to indexer
+      # TODO: what are we indexing?
       site.posts.docs.each do |doc|
         indexer << doc.data.merge({
           id: doc.basename_without_ext,
           content: doc.content
         })
       end
 
+      # Signal to the indexer that we're done adding content
       indexer.finish
+
+
+    # Handle any exceptions gracefully
     rescue => e
       $stderr.puts "Searchyll: #{e.class.name} - #{e.message}"
     end
+
+    # Figure out the Elasticsearch URL, from an environment variable or the
+    # Jekyll site configuration. Raises an exception if none is found, so we
+    # can skip the indexing.
+    def elasticsearch_url(site)
+      ENV['BONSAI_URL'] || ENV['ELASTICSEARCH_URL'] ||
+      ((site.config||{})['elasticsearch']||{})['url'] ||
+      raise(ArgumentError, "No Elasticsearch URL present, skipping indexing")
+    end
+
   end
 
 end