Meta descriptions are pretty useful for search engines and also for an item summary from other pages.

doc-src/content/reference/blueprint.haml

@@ -5,6 +5,7 @@ framework: blueprint
 stylesheet: _blueprint.sass
 classnames:
   - reference
+meta_description: The Blueprint Framework -- ported to Sass.
 ---
 
 - render 'reference' do

doc-src/content/reference/compass.haml

@@ -5,6 +5,7 @@ framework: compass
 stylesheet: _compass.sass
 classnames:
   - reference
+meta_description: The Compass Core Framework.
 ---
 - render 'reference' do
   %p

doc-src/content/reference/compass/css3.haml

@@ -1,10 +1,11 @@
 --- 
-title: Compass Css3
+title: Compass CSS3
-crumb: Css3
+crumb: CSS3
 framework: compass
 stylesheet: compass/_css3.sass
 classnames:
   - reference
+meta_description: Provides cross browser CSS3 mixins that take advantage of available pre-spec vendor prefixes. 
 ---
 - render 'reference' do
   %p

doc-src/content/reference/compass/layout.haml

@@ -3,6 +3,7 @@ title: Compass Layout
 crumb: Layout
 framework: compass
 stylesheet: compass/_layout.sass
+meta_description: Page layout module. So far, this is just the sticky-footer mixin.
 classnames:
   - reference
 ---

doc-src/content/reference/compass/misc.haml

@@ -3,6 +3,7 @@ title: Compass Misc
 crumb: Misc
 framework: compass
 stylesheet: compass/_misc.sass
+meta_description: Cute stuff you probably don't need.
 classnames:
   - reference
 ---

doc-src/content/reference/compass/reset.haml

@@ -5,6 +5,7 @@ framework: compass
 stylesheet: compass/_reset.sass
 classnames:
   - reference
+meta_description: Adds a CSS Reset into your stylesheet.
 ---
 - render 'reference' do
   %p

doc-src/content/reference/compass/utilities.haml

@@ -5,6 +5,7 @@ framework: compass
 stylesheet: compass/_utilities.sass
 classnames:
   - reference
+meta_description: Provides basic mixins for common styling patterns.
 ---
 - render 'reference' do
   %p

doc-src/layouts/default.haml

@@ -4,6 +4,8 @@
     %title
       #{@item[:title]} - Compass
     %meta{ :content => "text/html; charset=utf-8", "http-equiv" => "Content-Type" }
+    - if @item[:meta_description]
+      %meta{:name => "description", :content => @item[:meta_description]}
     %link(rel="shortcut icon" type="image/png" href="/docs/images/compass_icon.png")
     %link{ :href => "/docs/stylesheets/main.css", :rel => "stylesheet", :type => "text/css", :media => "screen" }
     %link{ :href => "/docs/stylesheets/ui-lightness/jquery-ui-1.7.2.custom.css", :rel => "stylesheet", :type => "text/css", :media => "screen" }

doc-src/layouts/example.haml

@@ -4,6 +4,8 @@
     %title
       #{@item[:title]} - Compass
     %meta{ :content => "text/html; charset=utf-8", "http-equiv" => "Content-Type" }
+    - if @item[:meta_description]
+      %meta{:name => "description", :content => @item[:meta_description]}
     %link(rel="shortcut icon" type="image/png" href="/docs/images/compass_icon.png")
     %link{ :href => "/docs/stylesheets/example.css", :rel => "stylesheet", :type => "text/css", :media => "screen" }
     %style{:type => "text/css"}= example_css