From 2e55329b8b2ee85a11024588c033b2d55e833512 Mon Sep 17 00:00:00 2001 From: Dario Ernst Date: Mon, 12 Oct 2020 21:16:17 +0200 Subject: [PATCH] Improve changelog and release texts for 1.8 --- AUTHORS.md | 3 +++ CHANGELOG.md | 6 ++++-- docs/releases.rst | 38 +++++++++++++++++++------------------- 3 files changed, 26 insertions(+), 21 deletions(-) diff --git a/AUTHORS.md b/AUTHORS.md index cc3fb518..c189cfb5 100644 --- a/AUTHORS.md +++ b/AUTHORS.md @@ -25,3 +25,6 @@ Other contributors: - [Tim Mohlmann](https://github.com/muhlemmer) - [Contributions](https://github.com/Mailu/Mailu/commits?author=muhlemmer) - [Ionut Filip](https://github.com/ionutfilip) - [Contributions](https://github.com/Mailu/Mailu/commits?author=ionutfilip) - [Ichikawa Yuriko](https://github.com/IchikawaYukko) - [Contributions](https://github.com/Mailu/Mailu/commits?author=IchikawaYukko) Japanese translation + - [Dimitri Huisman](https://github.com/Diman0) - [Contributions](https://github.com/Mailu/Mailu/commits?author=Diman0) + - [lub](https://github.com/lub) - [Contributions](https://github.com/Mailu/Mailu/commits?author=lub) + - [Dario Ernst](https://github.com/Nebukadneza) - [Contributions](https://github.com/Mailu/Mailu/commits?author=Nebukadneza) diff --git a/CHANGELOG.md b/CHANGELOG.md index 708eb092..57fc8102 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,8 +4,10 @@ Changelog Upgrade should run fine as long as you generate a new compose or stack configuration and upgrade your mailu.env. -There are some changes to the configuration overrides. Override files are now mounted read-only into the containers. -The Dovecot and Postfix overrides are moved in their own sub-directory. +Please note that the current 1.8 is what we call a "soft release": It’s there for everyone to see and use, but to limit possible user-impact of this very big release, it’s not yet the default in the setup-utility for new users. When upgrading, please treat it with some care, and be sure to always have backups! + +There are some changes to the configuration overrides. Override files are now mounted read-only into the containers. +The Dovecot and Postfix overrides are moved in their own sub-directory. If there are local override files, they will need to be moved from overrides/ to overrides/dovecot and overrides/postfix/. See https://mailu.io/1.8/faq.html#how-can-i-override-settings for all the mappings. diff --git a/docs/releases.rst b/docs/releases.rst index 0613c91c..831bc8cc 100644 --- a/docs/releases.rst +++ b/docs/releases.rst @@ -5,29 +5,22 @@ Mailu 1.8 - 2020-10-02 ---------------------- Release 1.8 has come a long way again. Due to corona the project slowed down to a crawl. Fortunately new contributors have joined the team what enabled us to still release Mailu 1.8 this year. -For a list of all changes refer to CHANGELOG.md in the root folder of the Mailu github project. Please read the 'Override location changes' section. It contains important information for the people who use the overrides folder. -New functionality -````````````````` +Please note that the current 1.8 is what we call a "soft release": It’s there for everyone to see and use, but to limit possible user-impact of this very big release, it’s not yet the default in the setup-utility for new users. When upgrading, please treat it with some care, and be sure to always have backups! -short summary of new features +For a list of all changes refer to `CHANGELOG.md` in the root folder of the Mailu github project. Please read the 'Override location changes' section. It contains important information for the people who use the overrides folder. -- placeholder1 -- placeholder2 +New Functionality & Improvements +```````````````````````````````` -mention alpine is updated in .... containers. +Here’s a short summary of new features: -other interesting section -````````````````````````` - -bla bla bla. -more bla bla bla. - -Override location changes -````````````````````````` - -If you have regenerated the Docker compose and environment files, there are some changes to the configuration overrides. -Override files are now mounted read-only into the containers. The Dovecot and Postfix overrides are moved in their own sub-directory. If there are local override files, they will need to be moved from ``overrides/`` to ``overrides/dovecot`` and ``overrides/postfix/``. +- Full-text-search is back after having been disabled for a while due to nasty bugs. +- Tons of documentation improvements, especially geared towards new users. +- (Experimental) support for different architectures, such as ARM. +- Improvements around webmails, such as CardDAV and a new skin for an updated roundcube, and support for MySQL for it. +- Improvements around relaying, such as AUTH LOGIN and non-standard port support. +- Update to alpine:3.12 as baseimage for most containers. Upgrading ````````` @@ -36,9 +29,16 @@ Upgrade should run fine as long as you generate a new compose or stack configuration and upgrade your mailu.env. Please not that the shipped image for PostgreSQL database is deprecated. -The shipped image for PostgreSQL is not maintained anymore from release 1.8. +The shipped image for PostgreSQL is not maintained anymore from release 1.8. We recommend switching to an external database as soon as possible. +Override location changes +^^^^^^^^^^^^^^^^^^^^^^^^^ + +If you have regenerated the Docker compose and environment files, there are some changes to the configuration overrides. +Override files are now mounted read-only into the containers. The Dovecot and Postfix overrides are moved in their own sub-directory. If there are local override files, they will need to be moved from ``overrides/`` to ``overrides/dovecot`` and ``overrides/postfix/``. + + Mailu 1.7 - 2019-08-22 ----------------------