diff --git a/doc-src/content/reference/compass/css3/box_shadow.haml b/doc-src/content/reference/compass/css3/box_shadow.haml
index e63de6ec..4258bfcb 100644
--- a/doc-src/content/reference/compass/css3/box_shadow.haml
+++ b/doc-src/content/reference/compass/css3/box_shadow.haml
@@ -12,6 +12,6 @@ classnames:
   - css3
 ---
 - render 'reference' do
-  %p
+  %p.warning
     This import is deprecated. Please import
-    <a href="/docs/reference/compass/css3/box_shadow_v2/">box_shadow_v2</a> instead.
\ No newline at end of file
+    <a href="/docs/reference/compass/css3/box_shadow_v2/" class="better">box_shadow_v2</a> instead.
\ No newline at end of file
diff --git a/doc-src/content/reference/compass/css3/text_shadow.haml b/doc-src/content/reference/compass/css3/text_shadow.haml
index e16647f6..d5ed7710 100644
--- a/doc-src/content/reference/compass/css3/text_shadow.haml
+++ b/doc-src/content/reference/compass/css3/text_shadow.haml
@@ -12,6 +12,6 @@ classnames:
   - css3
 ---
 - render 'reference' do
-  %p
+  %p.warning
     This import is deprecated. Please import
-    <a href="/docs/reference/compass/css3/text_shadow_v2/">text_shadow_v2</a> instead.
+    <a href="/docs/reference/compass/css3/text-shadow-v2/" class="better">text_shadow_v2</a> instead.
diff --git a/doc-src/content/reference/compass/css3/transform.haml b/doc-src/content/reference/compass/css3/transform.haml
index c671a6a1..fba7bfb8 100644
--- a/doc-src/content/reference/compass/css3/transform.haml
+++ b/doc-src/content/reference/compass/css3/transform.haml
@@ -12,6 +12,6 @@ classnames:
   - css3
 ---
 - render 'reference' do
-  %p
+  %p.warning
     This import is deprecated. Please import
-    <a href="/docs/reference/compass/css3/transform_v2/">transform_v2</a> instead.
+    <a href="/docs/reference/compass/css3/transform-v2/" class="better">transform_v2</a> instead.
diff --git a/doc-src/content/stylesheets/_reference.scss b/doc-src/content/stylesheets/_reference.scss
index 44ec523c..a16706ca 100644
--- a/doc-src/content/stylesheets/_reference.scss
+++ b/doc-src/content/stylesheets/_reference.scss
@@ -102,4 +102,11 @@ body.helpers {
   .helper {
     dl { @extend dl.table; }
   }
+}
+
+.warning {
+  $warning-color: #900;
+  color: $warning-color;
+  a { color: $warning-color; text-decoration: underline; }
+  a.better { color: adjust-hue($warning-color, 120deg); @include hover-link; }
 }
\ No newline at end of file