From f55a00ecef6d9b4047ea483df881eff9066370bf Mon Sep 17 00:00:00 2001
From: Andrew Godwin
Date: Thu, 15 Dec 2022 15:57:29 -0700
Subject: Start documenting 0.6 changes

---
 docs/releases/0.6.rst | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 docs/releases/0.6.rst

(limited to 'docs/releases/0.6.rst')

diff --git a/docs/releases/0.6.rst b/docs/releases/0.6.rst
new file mode 100644
index 0000000..c805c8d
--- /dev/null
+++ b/docs/releases/0.6.rst
@@ -0,0 +1,40 @@
+0.6
+===
+
+*Not Yet Released*
+
+This is a placeholder release note.
+
+You can download images from `Docker Hub <https://hub.docker.com/r/jointakahe/takahe>`_,
+or use the image name ``jointakahe/takahe:0.6``.
+
+
+Upgrade Notes
+-------------
+
+Signed Cookie Sessions
+~~~~~~~~~~~~~~~~~~~~~~
+
+As of version 0.6, Takahē uses signed cookies for sessions rather than a
+database table. As part of this change, when you upgrade, all users will be
+signed out, but no data will be lost - they just need to sign in again.
+
+
+Storage Settings
+~~~~~~~~~~~~~~~~
+
+If you use Google Cloud for storage, the URI format has changed - before it was
+``gcs://bucketname``, and now it is ``gs:///bucketname``.
+
+
+Migrations
+~~~~~~~~~~
+
+There are new database migrations, but for once, they are not fully
+backwards-compatible, as we've deleted the unneeded ``stator_errors`` table.
+
+To apply these migrations, you should:
+
+* Stop all Stator processes (it's fine to leave webservers going)
+* Apply the migrations
+* Start new Stator processes
-- 
cgit v1.2.3