Clean up the nav and main css3 page a bit

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>.
+%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.

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.

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

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.

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.

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

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

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;