Document the new box shadow api

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

@@ -1,10 +1,11 @@
 --- 
 title: Compass Box Shadow
-crumb: Box Shadow
+crumb: Box Shadow (Deprecated)
 framework: compass
 stylesheet: compass/css3/_box-shadow.scss
 meta_description: Specify the box shadow for all browsers.
 layout: core
+deprecated: true
 classnames:
   - reference
   - core
@@ -12,4 +13,5 @@ classnames:
 ---
 - render 'reference' do
   %p
-    The box-shadow mixin is used to give a block element a drop shadow.
+    This import is deprecated. Please import
+    <a href="/docs/reference/compass/css3/box_shadow_v2/">box_shadow_v2</a> instead.

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

@@ -0,0 +1,15 @@
+--- 
+title: Compass Box Shadow (v2)
+crumb: Box Shadow (v2)
+framework: compass
+stylesheet: compass/css3/_box-shadow-v2.scss
+meta_description: Specify the box shadow for all browsers.
+layout: core
+classnames:
+  - reference
+  - core
+  - css3
+---
+- render 'reference' do
+  %p
+    The box-shadow mixins are used to apply an inset or drop shadow to a block element.

doc-src/content/stylesheets/_sidebar.sass

@@ -55,6 +55,8 @@ aside[role="sidebar"]
         background: #f5f5f5
         &.selected
           font-weight: bold
+        &.deprecated span
+          text-decoration: line-through
         &:hover, &:focus, &.selected
           +border-radius
           +text-shadow(lighten($c, 15), 0, 1px)

doc-src/layouts/partials/sidebar/item.haml

@@ -1,2 +1,4 @@
-%li{:class => ("selected" if @selected)}
-  %a{:href => default_path(@current_item), :class => ("selected" if @selected)}= @crumb
+- classes = [("selected" if @selected), ("deprecated" if @current_item[:deprecated])].compact.join(" ")
+%li{:class => classes}
+  %a{:href => default_path(@current_item), :class => classes}
+    %span= @crumb