diff --git a/doc-src/content/CHANGELOG.markdown b/doc-src/content/CHANGELOG.markdown
index 30d0b6d1..96e0ec50 100644
--- a/doc-src/content/CHANGELOG.markdown
+++ b/doc-src/content/CHANGELOG.markdown
@@ -7,8 +7,17 @@ layout: article
COMPASS CHANGELOG
=================
-0.11.alpha.1 (UNRELEASED)
--------------------------
+Upgrading compass is really easy.
+Don't let all these details [scare you...](/docs/tutorials/im-scared-to-upgrade/)
+
+The Documentation for the [latest stable release](http://compass-style.org/docs/):
+
+The Documentation for the [latest preview release](http://beta.compass-style.org/docs/)
+
+0.11.alpha.1 (11/16/2010)
+---------------------------
+
+Note: Compass does not currently support Sass 3.1 alphas.
### Deprecations
@@ -26,25 +35,44 @@ COMPASS CHANGELOG
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.
+* Passing an argument to the `blueprint-scaffolding` mixin is not necessary
+ and has been deprecated.
+* Some blueprint color defaults now use color functions instead of color arithmetic.
+ This may result in different output for those who have color customizations.
### Blueprint
-* Deprecations:
- - Passing an argument to the blueprint-scaffolding mixin is not necessary
- and has been deprecated.
-* Some color defaults now use color functions instead of color arithmetic.
- This may result in different output for those who have color customizations.
* Updated from blueprint 0.9 to blueprint 1.0
- * Added detailed explanations to core uncompressed CSS files [CMM]
* Added .info and .alert classes to forms.css [CMM]
* Fixed numerous bugs in forms, including the fieldset padding bug in IE6-8 [CMM]
* Fixed specificity problems in typography.css and grid.css [CMM]
* See Lighthouse for more bug fixes
- * Full [changelog][blueprint_10_change]
+ * Full [blueprint changelog][blueprint_10_change]
* If for some reason you'd like to stay on the older version of blueprint you can run
the following command in your project before you upgrade (or after temporarily downgrading):
`compass unpack blueprint`
+### CSS3 v2.0
+
+Our CSS3 module makes writing CSS3 today almost as easy as it will be when all
+the browsers officially support the new features. The second version of the
+compass CSS module brings the API up to date with developments over the past
+6 to 9 months of browser changes and more closely matching the most recent CSS
+specifications. Summary of changes:
+
+* Support for multiple box shadows and text shadows
+* Support for 2d and 3d transforms
+* Opt-in SVG support for gradients in opera and IE9.
+ Set `$experimental-support-for-svg : true` in your
+ stylesheet to enable it.
+* Fixed a radial gradient position bug.
+* To generate a simple linear gradient in IE6 & 7, you can now use
+ the `filter-gradient` mixin.
+* New `background-image` mixin with gradient support and allowing
+ up to 10 images.
+* Gradient support for the border-image property.
+* Gradient support for list-style-image property.
+* Gradient support for the content property.
### Helpers
@@ -68,6 +96,8 @@ COMPASS CHANGELOG
If you provide a number with units of `deg` then it will return a unitless number
after converting to radians. Otherwise, it assumes the number is a radian length measure
and passes the units along to the result.
+* `ie-hex-str($color)` returns a #AARRGGBB formatted color suitable for
+ passing to IE filters.
* A new function `if()` that allows you to switch on a value without using `@if`.
Usage: `if($truth-value, $value-if-true, $value-if-false)`.
* Compass has added a number of new helper functions for lists that begin with
@@ -75,9 +105,25 @@ COMPASS CHANGELOG
are not to be used by compass users. Sass 3.1 will have proper list support,
these are a work around until that time.
+### Configuration
+
+* Added a new configuration property to disable sass warnings: `disable_warnings`
+
+### Core Framework
+
+* New layout mixins for absolute positioning: stretch, stretch-x, stretch-y
+
### Rails
-* Better integration with rails 3 (XXX Details)
+* In rails 3, there's no need for an initializer. Instead we use a
+ Railstie.
+* We now default to app/stylesheets for sass files and public/stylesheets for
+ css files -- though they can still be changed after installation or on the
+ command line during project initialization.
+* Compass is now a gem plugin in a rails environment.
+* In a rails3 environment the compass configuration can now be
+ changed without restarting the rails server process.
+
0.10.7 (UNRELEASED)
-------------------
diff --git a/doc-src/content/tutorials/im-scared-to-upgrade.markdown b/doc-src/content/tutorials/im-scared-to-upgrade.markdown
new file mode 100644
index 00000000..0233b9aa
--- /dev/null
+++ b/doc-src/content/tutorials/im-scared-to-upgrade.markdown
@@ -0,0 +1,58 @@
+---
+title: I'm Scared to Upgrade
+layout: tutorial
+crumb: Scared to Upgrade?
+classnames:
+ - tutorial
+---
+# I'm scared to upgrade.
+
+Why? Don't ya trust me? I won't break your stylesheets. Cross my heart. All those
+200+ github issues were feature requests. Honest. But you know, they might change
+a little. Probably not in any meaningful way. Like a default that used to be
+specified in the output might be omitted because it's the browser default anyway.
+
+## Trust but verify.
+
+But you should probably keep me on my toes. Follow these simple steps to see
+what changed to your stylesheets:
+
+*(Steps beginning with a $ are command line commands. Don't type the $.)*
+
+1. $ cd my_compass_project
+2. $ compass compile --force
+3. $ cp -r stylesheets stylesheets.backup
+4. $ gem install compass --pre # you might need to type sudo first if you're on mac or linux.
+5. $ compass compile --force
+6. Take note of any deprecation warnings printed in red during the compile.
+7. If you have textmate and installed the `mate` command line tool:
+ $ diff -r stylesheets.backup stylesheets | mate
+8. If you have not installed the `mate` tool:
+ $ sudo ln -s /Applications/TextMate.app/Contents/Resources/mate /usr/local/bin/mate
+ Then perform step 7.
+9. If you do not have Textmate, run the diff command like so:
+ $ diff -y -r stylesheets.backup stylesheets | less
+10. Scroll or use your arrow keys to review the differences between the files.
+11. If you're satisfied: $ git commit -a -m "Upgraded compass"
+12. If you're scared again:
+ A. Don't panic.
+ B. Read the [CHANGELOG](http://compass-style.org/docs/CHANGELOG/) and
+ see if the changes are explained there.
+ B. Send an email to the [mailing list](http://groups.google.com/group/compass-users)
+ explaining the problem and providing enough context like snippets from your diff
+ and the relevant snippets of your sass/scss files. In rare cases we might request
+ that you construct a simple compass project that exhibits the issue and make an
+ archive of it and send us an email with it attached.
+ C. If it's pretty obviously a bug. Please file an issue
+ on [github](http://github.com/chriseppstein/compass/issues). If you're experiencing
+ a crash, please run the command with the --trace option and record the output for
+ diagnostic purposes.
+ D. $ sudo gem uninstall compass
+ Select the newest version of compass. You have now downgraded to the old
+ version of compass.
+ E. $ compass compile --force
+ F. Diff the folders as in steps 7 through 9.
+13. Breathe a sigh of relief.
+
+
+