diff --git a/lib/hero.rb b/lib/hero.rb
index <HASH>..<HASH> 100644
--- a/lib/hero.rb
+++ b/lib/hero.rb
@@ -4,6 +4,13 @@ end
 
 module Hero
   class << self
+
+    # You can optionally register a Logger with Hero.
+    # If set, a logger.info message will be written for each step called when running Hero::Formulas.
+    #
+    # @example
+    #   Hero.logger = Logger.new(STDOUT)
     attr_accessor :logger
+
   end
 end
Added docs to the logger setter.