From f43f029a1878ebabc61cc0a191f1c35acd55439b Mon Sep 17 00:00:00 2001
From: Agate <me@agate.blue>
Date: Sun, 23 Aug 2020 15:21:29 +0200
Subject: [PATCH] Version bump and changelog for 1.0-rc1

---
 CHANGELOG                                     | 137 +++++++++++++++++-
 api/funkwhale_api/__init__.py                 |   2 +-
 changes/changelog.d/1053.feature              |   1 -
 changes/changelog.d/1083.enhancement          |   1 -
 changes/changelog.d/1088.enhancement          |   1 -
 changes/changelog.d/1089.bugfix               |   1 -
 changes/changelog.d/1099.enhancement          |   1 -
 changes/changelog.d/1102.enhancement          |   1 -
 changes/changelog.d/1105.feature              |   1 -
 changes/changelog.d/1121.enhancement          |   1 -
 changes/changelog.d/1125.enhancement          |   1 -
 changes/changelog.d/1127.enhancement          |   1 -
 changes/changelog.d/1128.enhancement          |   1 -
 changes/changelog.d/1130.enhancement          |   1 -
 changes/changelog.d/1131.enhancement          |   1 -
 changes/changelog.d/1140.bugfix               |   1 -
 changes/changelog.d/1144.bugfix               |   1 -
 changes/changelog.d/1178.enhancement          |   1 -
 changes/changelog.d/1180.bugfix               |   1 -
 changes/changelog.d/1190.enhancement          |   1 -
 changes/changelog.d/1193.bugfix               |   1 -
 changes/changelog.d/292.enhancement           |   1 -
 changes/changelog.d/370.feature               |   1 -
 changes/changelog.d/407.enhancement           |   1 -
 changes/changelog.d/858.enhancement           |   1 -
 changes/changelog.d/996.feature               |   1 -
 .../docker-installation-and-upgrade.doc       |   1 -
 changes/changelog.d/import-eaccess-fix.bugfix |   1 -
 changes/changelog.d/logout.enhancement        |   1 -
 changes/changelog.d/search-page.bugfix        |   1 -
 changes/changelog.d/thunbnails.enhancement    |   1 -
 31 files changed, 137 insertions(+), 31 deletions(-)
 delete mode 100644 changes/changelog.d/1053.feature
 delete mode 100644 changes/changelog.d/1083.enhancement
 delete mode 100644 changes/changelog.d/1088.enhancement
 delete mode 100644 changes/changelog.d/1089.bugfix
 delete mode 100644 changes/changelog.d/1099.enhancement
 delete mode 100644 changes/changelog.d/1102.enhancement
 delete mode 100644 changes/changelog.d/1105.feature
 delete mode 100644 changes/changelog.d/1121.enhancement
 delete mode 100644 changes/changelog.d/1125.enhancement
 delete mode 100644 changes/changelog.d/1127.enhancement
 delete mode 100644 changes/changelog.d/1128.enhancement
 delete mode 100644 changes/changelog.d/1130.enhancement
 delete mode 100644 changes/changelog.d/1131.enhancement
 delete mode 100644 changes/changelog.d/1140.bugfix
 delete mode 100644 changes/changelog.d/1144.bugfix
 delete mode 100644 changes/changelog.d/1178.enhancement
 delete mode 100644 changes/changelog.d/1180.bugfix
 delete mode 100644 changes/changelog.d/1190.enhancement
 delete mode 100644 changes/changelog.d/1193.bugfix
 delete mode 100644 changes/changelog.d/292.enhancement
 delete mode 100644 changes/changelog.d/370.feature
 delete mode 100644 changes/changelog.d/407.enhancement
 delete mode 100644 changes/changelog.d/858.enhancement
 delete mode 100644 changes/changelog.d/996.feature
 delete mode 100644 changes/changelog.d/docker-installation-and-upgrade.doc
 delete mode 100644 changes/changelog.d/import-eaccess-fix.bugfix
 delete mode 100644 changes/changelog.d/logout.enhancement
 delete mode 100644 changes/changelog.d/search-page.bugfix
 delete mode 100644 changes/changelog.d/thunbnails.enhancement

diff --git a/CHANGELOG b/CHANGELOG
index 7a4fde6098..9fff56b899 100644
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -10,6 +10,140 @@ This changelog is viewable on the web at https://docs.funkwhale.audio/changelog.
 
 .. towncrier
 
+1.0-rc1 (2020-23-08)
+--------------------
+
+Upgrade instructions are available at
+https://docs.funkwhale.audio/index.html
+
+
+Dropped python 3.5 support [manual action required, non-docker only]
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+With Funkwhale 1.0, we're dropping support for Python 3.5. Before upgrading,
+ensure ``python3 --version`` returns ``3.6`` or higher.
+
+If it returns ``3.6`` or higher, you have nothing to do.
+
+If it returns ``3.5``, you will need to upgrade your Python version/Host, then recreate your virtual environment::
+
+    rm -rf /srv/funkwhale/virtualenv
+    python3 -m venv /srv/funkwhale/virtualenv
+
+
+Increased quality of JPEG thumbnails [manual action required]
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Default quality for JPEG thumbnails was increased from 70 to 95, as 70 was producing visible artifacts in resized images.
+
+Because of this change, existing thumbnails will not load, and you will need to:
+
+1. delete the ``__sized__`` directory in your ``MEDIA_ROOT`` directory
+2. run ``python manage.py fw media generate-thumbnails`` to regenerate thumbnails with the enhanced quality
+
+If you don't want to regenerate thumbnails, you can keep the old ones by adding ``THUMBNAIL_JPEG_RESIZE_QUALITY=70`` to your .env file.
+
+Small API breaking change in ``/api/v1/libraries``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To allow easier crawling of public libraries on a pod,we had to make a slight breaking change
+to the behaviour of ``GET /api/v1/libraries``.
+
+Before, it returned only libraries owned by the current user.
+
+Now, it returns all the accessible libraries (including ones from other users and pods).
+
+If you are consuming the API via a third-party client and need to retrieve your libraries,
+use the ``scope`` parameter, like this: ``GET /api/v1/libraries?scope=me``
+
+API breaking change in ``/api/v1/albums``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To increase performance, querying ``/api/v1/albums`` doesn't return album tracks anymore. This caused
+some performance issues, especially as some albums and series have dozens or even hundreds of tracks.
+
+If you want to retrieve tracks for an album, you can query ``/api/v1/tracks/?album=<albumid>``.
+
+JWT deprecation
+^^^^^^^^^^^^^^^
+
+API Authentication using JWT is deprecated and will be removed in Funkwhale 1.0. Please use OAuth or application tokens
+and refer to our API documentation at https://docs.funkwhale.audio/swagger/ for guidance.
+
+Full list of changes
+^^^^^^^^^^^^^^^^^^^^
+
+Features:
+
+- Allow users to hide compilation artists on the artist search page (#1053)
+- Can now launch server import from the UI (#1105)
+- Dedicated, advanced search page (#370)
+- Persist theme and language settings accross sessions (#996)
+
+
+Enhancements:
+
+- Add support for unauthenticated users hitting the logout page
+- Added support for Licence Art Libre (#1088)
+- Broadcast/handle rejected follows (#858)
+- Confirm email without requiring the user to validate the form manually (#407)
+- Display channel and track downloads count (#1178)
+- Do not include tracks in album API representation (#1102)
+- Dropped python 3.5 support. Python 3.6 is the minimum required version (#1099)
+- Improved keyboard accessibility (#1125)
+- Improved naming of pages for accessibility (#1127)
+- Improved shuffle behaviour (#1190)
+- Increased quality of JPEG thumbnails
+- Lock focus in modals to improve accessibility (#1128)
+- More consistent search UX on /albums, /artists, /radios and /playlists (#1131)
+- Play button now replace current queue instead of appending to it (#1083)
+- Set proper lang attribute on HTML document (#1130)
+- Use semantic headers for accessibility (#1121)
+- Users can now update their email address (#292)
+
+
+Bugfixes:
+
+- Fix broken media support detection (#1180)
+- Fix layout issue with playbar on landscape tablets (#1144)
+- Fix random radio so that podcast content is not picked up (#1140)
+- Fixed an issue with search pages where results would not appear after navigating to another page
+- Fixed crash with negative track position in file tags (#1193)
+- Handle access errors scanning directories when importing files
+- Make channel card updated times more humanly readable, add internationalization (#1089)
+
+
+Documentation:
+
+- Simplify Docker mono-container installation and upgrade documentation
+
+
+Contributors to this release (translation, development, documentation, reviews, design, testing, third-party projects):
+
+- Agate
+- Andy Craze
+- anonymous
+- appzer0
+- Arne
+- Bheesham Persaud
+- Ciarán Ainsworth
+- Creak
+- Daniele Lira Mereb
+- dulz
+- Francesc Galí
+- ghose
+- mekind
+- Puri
+- Quentin PAGÈS
+- Raphaël Ventura
+- Simon Arlott
+- Slimane Selyan Amiri
+- Stefano Pigozzi
+- Sébastien de Melo
+- vicdorke
+- Xosé M
+
+
 0.21.2 (2020-07-27)
 -------------------
 
@@ -223,7 +357,8 @@ All user-related commands are available under the ``python manage.py fw users``
 Please refer to the `Admin documentation <https://docs.funkwhale.audio/admin/commands.html#user-management>`_ for
 more information and instructions.
 
-Progressive web app [Manual action suggested, non-docker only]
+Progressive web app [Manual action sugFull list of changes
+^^^^^^^^^^^^^^^^^^^^gested, non-docker only]
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 We've made Funkwhale's Web UI a Progressive Web Application (PWA), in order to improve the user experience
diff --git a/api/funkwhale_api/__init__.py b/api/funkwhale_api/__init__.py
index 0317f7328d..72a793c35e 100644
--- a/api/funkwhale_api/__init__.py
+++ b/api/funkwhale_api/__init__.py
@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-__version__ = "0.21.2"
+__version__ = "1.0-rc1"
 __version_info__ = tuple(
     [
         int(num) if num.isdigit() else num
diff --git a/changes/changelog.d/1053.feature b/changes/changelog.d/1053.feature
deleted file mode 100644
index 8f4c1b9d4d..0000000000
--- a/changes/changelog.d/1053.feature
+++ /dev/null
@@ -1 +0,0 @@
-Allow users to hide compilation artists on the artist search page (#1053)
\ No newline at end of file
diff --git a/changes/changelog.d/1083.enhancement b/changes/changelog.d/1083.enhancement
deleted file mode 100644
index 375ccd3dce..0000000000
--- a/changes/changelog.d/1083.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Play button now replace current queue instead of appending to it (#1083)
\ No newline at end of file
diff --git a/changes/changelog.d/1088.enhancement b/changes/changelog.d/1088.enhancement
deleted file mode 100644
index 150a7e2cd6..0000000000
--- a/changes/changelog.d/1088.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Added support for Licence Art Libre (#1088)
\ No newline at end of file
diff --git a/changes/changelog.d/1089.bugfix b/changes/changelog.d/1089.bugfix
deleted file mode 100644
index bc3b774391..0000000000
--- a/changes/changelog.d/1089.bugfix
+++ /dev/null
@@ -1 +0,0 @@
-Make channel card updated times more humanly readable, add internationalization (#1089)
\ No newline at end of file
diff --git a/changes/changelog.d/1099.enhancement b/changes/changelog.d/1099.enhancement
deleted file mode 100644
index 1c74e1fa3d..0000000000
--- a/changes/changelog.d/1099.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Dropped python 3.5 support. Python 3.6 is the minimum required version (#1099)
\ No newline at end of file
diff --git a/changes/changelog.d/1102.enhancement b/changes/changelog.d/1102.enhancement
deleted file mode 100644
index 6c80b79381..0000000000
--- a/changes/changelog.d/1102.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Do not include tracks in album API representation (#1102)
\ No newline at end of file
diff --git a/changes/changelog.d/1105.feature b/changes/changelog.d/1105.feature
deleted file mode 100644
index 152c2a7bee..0000000000
--- a/changes/changelog.d/1105.feature
+++ /dev/null
@@ -1 +0,0 @@
-Can now launch server import from the UI (#1105)
\ No newline at end of file
diff --git a/changes/changelog.d/1121.enhancement b/changes/changelog.d/1121.enhancement
deleted file mode 100644
index 188865c94c..0000000000
--- a/changes/changelog.d/1121.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Use semantic headers for accessibility (#1121)
\ No newline at end of file
diff --git a/changes/changelog.d/1125.enhancement b/changes/changelog.d/1125.enhancement
deleted file mode 100644
index 78de39e001..0000000000
--- a/changes/changelog.d/1125.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Improved keyboard accessibility (#1125)
\ No newline at end of file
diff --git a/changes/changelog.d/1127.enhancement b/changes/changelog.d/1127.enhancement
deleted file mode 100644
index 415b97b334..0000000000
--- a/changes/changelog.d/1127.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Improved naming of pages for accessibility (#1127)
\ No newline at end of file
diff --git a/changes/changelog.d/1128.enhancement b/changes/changelog.d/1128.enhancement
deleted file mode 100644
index 375d33ad30..0000000000
--- a/changes/changelog.d/1128.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Lock focus in modals to improve accessibility (#1128)
\ No newline at end of file
diff --git a/changes/changelog.d/1130.enhancement b/changes/changelog.d/1130.enhancement
deleted file mode 100644
index 07318ba95d..0000000000
--- a/changes/changelog.d/1130.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Set proper lang attribute on HTML document (#1130)
\ No newline at end of file
diff --git a/changes/changelog.d/1131.enhancement b/changes/changelog.d/1131.enhancement
deleted file mode 100644
index eb2f25b0b8..0000000000
--- a/changes/changelog.d/1131.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-More consistent search UX on /albums, /artists, /radios and /playlists (#1131)
\ No newline at end of file
diff --git a/changes/changelog.d/1140.bugfix b/changes/changelog.d/1140.bugfix
deleted file mode 100644
index d9702a5f45..0000000000
--- a/changes/changelog.d/1140.bugfix
+++ /dev/null
@@ -1 +0,0 @@
-Fix random radio so that podcast content is not picked up (#1140)
\ No newline at end of file
diff --git a/changes/changelog.d/1144.bugfix b/changes/changelog.d/1144.bugfix
deleted file mode 100644
index 3e96c031d3..0000000000
--- a/changes/changelog.d/1144.bugfix
+++ /dev/null
@@ -1 +0,0 @@
-Fix layout issue with playbar on landscape tablets (#1144)
\ No newline at end of file
diff --git a/changes/changelog.d/1178.enhancement b/changes/changelog.d/1178.enhancement
deleted file mode 100644
index b247fd0986..0000000000
--- a/changes/changelog.d/1178.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Display channel and track downloads count (#1178)
\ No newline at end of file
diff --git a/changes/changelog.d/1180.bugfix b/changes/changelog.d/1180.bugfix
deleted file mode 100644
index 262d1037ef..0000000000
--- a/changes/changelog.d/1180.bugfix
+++ /dev/null
@@ -1 +0,0 @@
-Fix broken media support detection (#1180)
\ No newline at end of file
diff --git a/changes/changelog.d/1190.enhancement b/changes/changelog.d/1190.enhancement
deleted file mode 100644
index b64dc9d920..0000000000
--- a/changes/changelog.d/1190.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Improved shuffle behaviour (#1190)
\ No newline at end of file
diff --git a/changes/changelog.d/1193.bugfix b/changes/changelog.d/1193.bugfix
deleted file mode 100644
index 2362eef8e6..0000000000
--- a/changes/changelog.d/1193.bugfix
+++ /dev/null
@@ -1 +0,0 @@
-Fixed crash with negative track position in file tags (#1193)
\ No newline at end of file
diff --git a/changes/changelog.d/292.enhancement b/changes/changelog.d/292.enhancement
deleted file mode 100644
index 8da9e9a13d..0000000000
--- a/changes/changelog.d/292.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Users can now update their email address (#292)
\ No newline at end of file
diff --git a/changes/changelog.d/370.feature b/changes/changelog.d/370.feature
deleted file mode 100644
index 381cd8e7cf..0000000000
--- a/changes/changelog.d/370.feature
+++ /dev/null
@@ -1 +0,0 @@
-Dedicated, advanced search page (#370)
\ No newline at end of file
diff --git a/changes/changelog.d/407.enhancement b/changes/changelog.d/407.enhancement
deleted file mode 100644
index c21a34063e..0000000000
--- a/changes/changelog.d/407.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Confirm email without requiring the user to validate the form manually (#407)
\ No newline at end of file
diff --git a/changes/changelog.d/858.enhancement b/changes/changelog.d/858.enhancement
deleted file mode 100644
index 7e0135e7c1..0000000000
--- a/changes/changelog.d/858.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Broadcast/handle rejected follows (#858)
\ No newline at end of file
diff --git a/changes/changelog.d/996.feature b/changes/changelog.d/996.feature
deleted file mode 100644
index 6c57c3c60d..0000000000
--- a/changes/changelog.d/996.feature
+++ /dev/null
@@ -1 +0,0 @@
-Persist theme and language settings accross sessions (#996)
\ No newline at end of file
diff --git a/changes/changelog.d/docker-installation-and-upgrade.doc b/changes/changelog.d/docker-installation-and-upgrade.doc
deleted file mode 100644
index e5cb86c803..0000000000
--- a/changes/changelog.d/docker-installation-and-upgrade.doc
+++ /dev/null
@@ -1 +0,0 @@
-Simplify Docker mono-container installation and upgrade documentation
diff --git a/changes/changelog.d/import-eaccess-fix.bugfix b/changes/changelog.d/import-eaccess-fix.bugfix
deleted file mode 100644
index 841a820d9d..0000000000
--- a/changes/changelog.d/import-eaccess-fix.bugfix
+++ /dev/null
@@ -1 +0,0 @@
-Handle access errors scanning directories when importing files
diff --git a/changes/changelog.d/logout.enhancement b/changes/changelog.d/logout.enhancement
deleted file mode 100644
index 4a0ccb81c7..0000000000
--- a/changes/changelog.d/logout.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Add support for unauthenticated users hitting the logout page
\ No newline at end of file
diff --git a/changes/changelog.d/search-page.bugfix b/changes/changelog.d/search-page.bugfix
deleted file mode 100644
index eb9bc69ddc..0000000000
--- a/changes/changelog.d/search-page.bugfix
+++ /dev/null
@@ -1 +0,0 @@
-Fixed an issue with search pages where results would not appear after navigating to another page
\ No newline at end of file
diff --git a/changes/changelog.d/thunbnails.enhancement b/changes/changelog.d/thunbnails.enhancement
deleted file mode 100644
index a402c654a5..0000000000
--- a/changes/changelog.d/thunbnails.enhancement
+++ /dev/null
@@ -1 +0,0 @@
-Increased quality of JPEG thumbnails
-- 
GitLab