1 files changed, 71 insertions, 0 deletions
diff --git a/doc/CHANGES.md b/doc/CHANGES.md
index efe3d4d71..dbea64bda 100644
--- a/doc/CHANGES.md
+++ b/doc/CHANGES.md
@@ -1,3 +1,74 @@
+# Version 0.6
+
+## Highlighted features
+
+* Ruby dependencies are now handled by Bundler
+* Support for invalidating accelerator cache -- this makes it much
+  less likely, when using Varnish, that users will be presented with
+  stale content.  Fixes
+  [issue #436](https://github.com/sebbacon/alaveteli/issues/436)
+* Adding a `GA_CODE` to `general.yml` will cause the relevant Google
+  Analytics code to be added to your rendered pages
+* It is now possible to have more than one theme installed.  The
+  behaviour of multiple themes is now layered in the reverse order
+  they're listed in the config file.  See the variable `THEME_URLS` in
+  `general.yml-example` for an example.
+* A new, experimental theme for the administrative interface.  It's
+  currently packaged as a standalone theme, but will be merged into
+  the core once it's been tested and iterated in production a few
+  times.
+* Alert subscriptions are now referred to as "following" a request (or
+  group of requests) throughout the UI.  When a user "follows" a
+  request, updates regarding that request are posted on a new "wall"
+  page.  Now they have a wall, users can opt not to receive alerts by
+  email.
+* New features to support fast post-moderation of bad requests: a
+  button for users to report potentially unsuitable requests, and a
+  form control in the administrative interface that hides a request
+  and sends the user an email explaining why.
+
+## Upgrade notes
+
+* Existing installations will need to install the Bundler gem.  See
+  `INSTALL.md` for details.
+
+* As a result of using bundler, the list of software packages that
+  should be installed has changed.  On Debian, you can run:
+
+      sudo apt-get install `cut -d " " -f 1 config/packages | grep -v "^#"`
+      
+  [This gist](https://gist.github.com/2584766) shows the changes to
+  `config/packages` since the previous release.
+
+* Because dependencies are now handled by Bundler, when you next run
+  the `rails-post-deploy` script, it will download, compile and
+  install various things.  Part of this is compiling xapian, which may
+  take a *long* time (subsequent deployments should be much faster)
+
+* To support invalidating the Varnish cache, ensure that there's a
+  value for `VARNISH_HOST` in `general.yml` (normally this would be
+  `localhost`).  You will also need to update your Varnish server to
+  support PURGE requests.  The example configuration provided at
+  `config/varnish-alaveteli.vcl` will work for Varnish 3 and above. If
+  you leave `VARNISH_HOST` blank, it will have no effect.  Finally,
+  you should install the `purge-varnish` init script that's provided
+  in `ugly` format at `config/purge-varnish-debian.ugly` to ensure the
+  purge queue is emptied regularly.
+
+* Administrators are now assumed to log in using standard user accounts
+  with superuser privileges (see 'Administrator Privileges' in
+  `INSTALL.md`). The old-style admin account (using credentials from
+  `general.yml`) is now known as the "emergency user".  Deployments
+  that previously bypassed admin authentication should set the new
+  `SKIP_ADMIN_AUTH` config variable to `true`.
+  
+* If you want to try out the new administrator theme, copy the sample
+  `THEME_URLS` config from `general.yml-example` and run
+  `./script/rails-post-deploy`.  If you don't like it, turn it off
+  again by removing the line referring to the theme
+  (`adminbootstraptheme`) -- but email the mailing list first,
+  explaining why!
+
 # Version 0.5.2
 
 This is a hotfix to fix occasional problems importing public body CSVs