diff --git a/doc-src/content/CHANGELOG.markdown b/doc-src/content/CHANGELOG.markdown
index 96e0ec50..d6cbf02f 100644
--- a/doc-src/content/CHANGELOG.markdown
+++ b/doc-src/content/CHANGELOG.markdown
@@ -8,7 +8,7 @@ COMPASS CHANGELOG
 =================
 
 Upgrading compass is really easy.
-Don't let all these details [scare you...](/docs/tutorials/im-scared-to-upgrade/)
+Don't let all these details [scare you...](/docs/tutorials/upgrading/im-scared/)
 
 The Documentation for the [latest stable release](http://compass-style.org/docs/):
 
diff --git a/doc-src/content/tutorials/upgrading/css3-v2.markdown b/doc-src/content/tutorials/upgrading/css3-v2.markdown
new file mode 100644
index 00000000..d3cc756d
--- /dev/null
+++ b/doc-src/content/tutorials/upgrading/css3-v2.markdown
@@ -0,0 +1,10 @@
+The `css3` import is deprecated as well as the following css3 modules:
+`box-shadow`, `text-shadow`, and `transform`. Instead import `css3/version-2`,
+`box-shadow-v2`, `text-shadow-v2`, and `transform-v2` respectively.
+However, you will only get deprecation warnings if you actually use
+one of the deprecated mixins. The imports will be restored by 1.0
+with the new, betterer APIs.
+
+You should read about what changed, update your stylesheets accordingly
+and then update your imports to the new version.
+
diff --git a/doc-src/content/tutorials/im-scared-to-upgrade.markdown b/doc-src/content/tutorials/upgrading/im-scared.markdown
similarity index 100%
rename from doc-src/content/tutorials/im-scared-to-upgrade.markdown
rename to doc-src/content/tutorials/upgrading/im-scared.markdown