Improve release notes for 0.7.0

1 files changed, 50 insertions, 22 deletions

diff --git a/RELEASES.md b/RELEASES.md
index 643e6aa8..51cf4342 100644
--- a/RELEASES.md
+++ b/RELEASES.md
@@ -1,37 +1,65 @@
 # Lemmy v0.7.0 Release (2020-06-23)
 
-## Breaking Change to our image server: Pictshare to Pict-rs migration guide
+This release replaces [pictshare](https://github.com/HaschekSolutions/pictshare)
+with [pict-rs](https://git.asonix.dog/asonix/pict-rs), which improves performance
+and security.
 
-This release replaces [pictshare](https://github.com/HaschekSolutions/pictshare) with [pict-rs](https://git.asonix.dog/asonix/pict-rs), and a script must be run on your server to upgrade.
+Overall, since our last major release in January (v0.6.0), we have closed over
+[100 issues!](https://github.com/LemmyNet/lemmy/milestone/16?closed=1)
 
-To update, run:
+- Site-wide list of recent comments
+- Reconnecting websockets
+- Many more themes, including a default light one.
+- Expandable embeds for post links (and thumbnails), from
+[iframely](https://github.com/itteco/iframely)
+- Better icons
+- Emoji autocomplete to post and message bodies, and an Emoji Picker
+- Post body now searchable
+- Community title and description is now searchable
+- Simplified cross-posts
+- Better documentation
+- LOTS more languages
+- Lots of bugs squashed
+- And more ...
 
+## Upgrading
+
+Before starting the upgrade, make sure that you have a working backup of your
+database and image files. See our
+[documentation](https://dev.lemmy.ml/docs/administration_backup_and_restore.html)
+for backup instructions.
+
+**With Ansible:**
+
+```
+# deploy with ansible from your local lemmy git repo
+git pull
+cd ansible
+ansible-playbook lemmy.yml
+# connect via ssh to run the migration script
+ssh your-server
+cd /lemmy/
+wget https://raw.githubusercontent.com/dessalines/lemmy/master/docker/prod/migrate-pictshare-to-pictrs.bash
+chmod +x migrate-pictshare-to-pictrs.bash
+sudo ./migrate-pictshare-to-pictrs.bash
+```
+
+**With manual Docker installation:**
 ```
+# run these commands on your server
 cd /lemmy
+wget https://raw.githubusercontent.com/dessalines/lemmy/master/ansible/templates/nginx.conf
+# Replace the {{ vars }}
+sudo mv nginx.conf /etc/nginx/sites-enabled/lemmy.conf
+sudo nginx -s reload
 wget https://raw.githubusercontent.com/dessalines/lemmy/master/docker/prod/docker-compose.yml
 wget https://raw.githubusercontent.com/dessalines/lemmy/master/docker/prod/migrate-pictshare-to-pictrs.bash
+chmod +x migrate-pictshare-to-pictrs.bash
 sudo bash migrate-pictshare-to-pictrs.bash
 ```
 
-You'll also have to update your nginx config, use the [one here](https://github.com/LemmyNet/lemmy/blob/master/ansible/templates/nginx.conf).
-
-*You'll have to log in again to pick up your avatar*
-
-Apart from that, we've closed [~100 issues!](https://github.com/LemmyNet/lemmy/milestone/16?closed=1), including:
-
-- Site-wide list of recent comments.
-- Reconnecting websockets.
-- Swapped out pictshare for [pict-rs](https://git.asonix.dog/asonix/pict-rs).
-- Lots more themes, including a default light one.
-- Expandable embeds for post links (and thumbnails), from iframely.
-- Better icons.
-- Emoji autocomplete to post and message bodies, and an Emoji Picker.
-- Post body now searchable.
-- Community title and description is now searchable.
-- Simplified cross-posts.
-- Better documentation.
-- LOTS more languages.
-- Lots of bugs squashed.
+**Note:** After upgrading, all users need to reload the page, then logout and
+login again, so that images are loaded correctly.
 
 # Lemmy v0.6.0 Release (2020-01-16)