lib/markaby.rb in markaby-0.2 vs lib/markaby.rb in markaby-0.3

@@ -1,8 +1,26 @@
+# = About lib/markany.rb
+#
+# By requiring <tt>lib/markaby</tt>, you can load Markaby's dependency (the Builder library,)
+# as well as the full set of Markaby classes.
+#
+# For a full list of features and instructions, see the README.
 $:.unshift File.expand_path(File.dirname(__FILE__))
 
+# Markaby is a module containing all of the great Markaby classes that
+# do such an excellent job.
+# 
+# * Markaby::Builder: the class for actually calling the Ruby methods
+#   which write the HTML.
+# * Markaby::CSSProxy: a class which adds element classes and IDs to
+#   elements when used within Markaby::Builder.
+# * Markaby::MetAid: metaprogramming helper methods.
+# * Markaby::Tags: lists the roles of various XHTML tags to help Builder
+#   use these tags as they are intended.
+# * Markaby::Template: a class for hooking Markaby into Rails as a
+#   proper templating language.
 module Markaby
-    VERSION = '0.2'
+    VERSION = '0.3'
 end
 
 unless defined?(Builder)
   require 'rubygems'
   require 'builder'