Initial attempt at documentation. Should be extended to methods as well

.cane

@@ -1,2 +1,2 @@
 --color
---max-violations 3
+--max-violations 0

.gitignore

@@ -1 +1,3 @@
 *.gem
+.yardoc
+/doc

Rakefile

@@ -12,12 +12,17 @@ end
 
 desc "Cleans unneeded or old files"
 task :clean do
-  Dir['*.gem'].each do |f|
-    rm f
+  Dir['{*.gem,doc}'].each do |f|
+    rm_rf f
   end
 end
 
 desc "Install locally"
 task :install => [:clean, :build] do
   sh 'gem', 'install', *Dir['*.gem']
 end
+
+desc "Create the documentation for the project"
+task :doc do
+  sh 'yard'
+end

lib/jekyll/compass/compass_file.rb

@@ -1,6 +1,8 @@
 
 module Jekyll
   module Compass
+    # This seemed to be necessary at the time, however I'm not sure now if it
+    # is or not. (very) minor performance boost.
     class CompassFile < StaticFile
       def write(destination)
         # Short-circuit to the inevitable

lib/jekyll/compass/generator.rb

@@ -6,6 +6,10 @@
 
 module Jekyll
   module Compass
+    # This is the main generator plugin for Jekyll. Jekyll finds these plugins
+    # itself, we just need to be setup by the user as a gem plugin for their
+    # website. The plugin will only do something if there is a `_sass` folder
+    # in the source folder of the Jekyll website.
     class Generator < ::Jekyll::Generator
       safe true
       priority :high