diff --git a/doc-src/content/reference/compass/css3.haml b/doc-src/content/reference/compass/css3.haml
index f4cb1c1b..ed0f77ee 100644
--- a/doc-src/content/reference/compass/css3.haml
+++ b/doc-src/content/reference/compass/css3.haml
@@ -11,11 +11,19 @@ classnames:
 meta_description: Provides cross browser CSS3 mixins that take advantage of available pre-spec vendor prefixes. 
 layout: core
 ---
-- render 'reference' do
-  %p
-    The CSS3 module provides cross-browser mixins for CSS properties
-    introduced in CSS3, for example <code id="border-radius">border-radius</code>
-    and <code id="text-shadow">text-shadow</code>.
-  %p
-    What rendering engines you support for the experimental css properties is governed by
-    the configurable variables defined in <a href="/docs/reference/compass/css3/shared/">the css3 shared module</a>.
\ No newline at end of file
+%h1 Compass CSS3 Module
+%p
+  The CSS3 module provides cross-browser mixins for CSS properties
+  introduced in CSS3, for example
+  <a href="/docs/reference/compass/css3/border_radius/"><code>border-radius</code></a>
+  and <a href="/docs/reference/compass/css3/text-shadow-v2/"><code>text-shadow</code></a>.
+%p
+  What rendering engines you support for the experimental css properties is governed by
+  the configurable variables defined in <a href="/docs/reference/compass/support/">the browser
+  support module</a>.
+%h3 Importing the Entire CSS3 Library
+%p
+  To import the CSS3 Module add the following to your stylesheets:<br>
+  <code>@import "compass/css3/version-2"</code><br>
+  Many of the mixins in version-1 are deprecated, and this import will make sure you don't
+  load them during this transition.
\ No newline at end of file
diff --git a/doc-src/content/reference/compass/css3/box_shadow.haml b/doc-src/content/reference/compass/css3/box_shadow.haml
index 4258bfcb..2a181d65 100644
--- a/doc-src/content/reference/compass/css3/box_shadow.haml
+++ b/doc-src/content/reference/compass/css3/box_shadow.haml
@@ -1,6 +1,6 @@
 --- 
 title: Compass Box Shadow
-crumb: Box Shadow (Deprecated)
+crumb: Box Shadow (v1)
 framework: compass
 stylesheet: compass/css3/_box-shadow.scss
 meta_description: Specify the box shadow for all browsers.
diff --git a/doc-src/content/reference/compass/css3/shared.haml b/doc-src/content/reference/compass/css3/shared.haml
index cc384789..f9a14cc5 100644
--- a/doc-src/content/reference/compass/css3/shared.haml
+++ b/doc-src/content/reference/compass/css3/shared.haml
@@ -1,6 +1,6 @@
 --- 
 title: Shared CSS3 Utilities
-crumb: CSS3 Utilities
+crumb: Shared Utilities
 framework: compass
 stylesheet: compass/css3/_shared.scss
 layout: core
diff --git a/doc-src/content/reference/compass/css3/text_shadow.haml b/doc-src/content/reference/compass/css3/text_shadow.haml
index d5ed7710..d29137c9 100644
--- a/doc-src/content/reference/compass/css3/text_shadow.haml
+++ b/doc-src/content/reference/compass/css3/text_shadow.haml
@@ -1,6 +1,6 @@
 --- 
 title: Compass Text Shadow
-crumb: Text Shadow (Deprecated)
+crumb: Text Shadow (v1)
 framework: compass
 stylesheet: compass/css3/_text-shadow.scss
 meta_description: Specify the text shadow for all browsers.
diff --git a/doc-src/content/reference/compass/css3/transform.haml b/doc-src/content/reference/compass/css3/transform.haml
index fba7bfb8..3f208e2d 100644
--- a/doc-src/content/reference/compass/css3/transform.haml
+++ b/doc-src/content/reference/compass/css3/transform.haml
@@ -1,6 +1,6 @@
 --- 
 title: Compass Transform
-crumb: Transform (Deprecated)
+crumb: Transform (v1)
 framework: compass
 stylesheet: compass/css3/_transform.scss
 meta_description: Specify the 2D transformation for all browsers.
diff --git a/doc-src/content/reference/compass/support.haml b/doc-src/content/reference/compass/support.haml
index f224af13..3c850761 100644
--- a/doc-src/content/reference/compass/support.haml
+++ b/doc-src/content/reference/compass/support.haml
@@ -9,7 +9,7 @@ classnames:
   - support
 meta_description: Provides configuration options for the Compass Browser Support Matrix.
 layout: core
-nav_stylesheet: _compass.scss
+navigable: false
 ---
 - render 'reference' do
   %p
diff --git a/doc-src/lib/default.rb b/doc-src/lib/default.rb
index 9aa26043..7f1bd1c7 100644
--- a/doc-src/lib/default.rb
+++ b/doc-src/lib/default.rb
@@ -73,6 +73,7 @@ def item_tree(item, options = {})
     child_opts[:heading_level] += 1 if child_opts[:heading_level]
     child_opts.delete(:omit_self)
     item.children.sort_by{|c| c[:crumb] || c[:title]}.each do |child|
+      next if child[:navigable] == false
       child_html << item_tree(child, child_opts)
     end
   else
diff --git a/frameworks/compass/stylesheets/compass/_support.scss b/frameworks/compass/stylesheets/compass/_support.scss
index f6e61615..710baf4a 100644
--- a/frameworks/compass/stylesheets/compass/_support.scss
+++ b/frameworks/compass/stylesheets/compass/_support.scss
@@ -24,4 +24,6 @@ $experimental-support-for-microsoft : true !default;
 // Support for khtml in experimental css3 properties.
 $experimental-support-for-khtml     : true !default;
 // Support for svg in experimental css3 properties.
+// Setting this to true might add significant size to your
+// generated stylesheets.
 $experimental-support-for-svg     : false !default;