Documented active_support/configurable

activesupport/lib/active_support/configurable.rb

@@ -4,6 +4,8 @@
 require 'active_support/core_ext/module/delegation'
 
 module ActiveSupport
+  # Configurable provides a <tt>config</tt> method to store and retrieve
+  # configuration options as an <tt>OrderedHash</tt>.
   module Configurable
     extend ActiveSupport::Concern
 
@@ -29,8 +31,25 @@ def #{name}=(value); config.#{name} = value; end
       end
     end
 
+    # Reads and writes attributes from a configuration <tt>OrderedHash</tt>.
+    # 
+    #   require 'active_support/configurable'      
+    #  
+    #   class User
+    #     include ActiveSupport::Configurable
+    #   end 
+    #
+    #   user = User.new
+    # 
+    #   user.config.allowed_access = true
+    #   user.config.level = 1
+    #
+    #   user.config.allowed_access # => true
+    #   user.config.level          # => 1
+    # 
     def config
       @_config ||= ActiveSupport::InheritableOptions.new(self.class.config)
     end
   end
-end
+end
+