From 60457be7943fe8a1196350c114ed0b9bf91e051c Mon Sep 17 00:00:00 2001
From: Matthias Schiffer <mschiffer@universe-factory.net>
Date: Thu, 7 Sep 2023 19:28:38 +0200
Subject: [PATCH] docs: releases/v2023.1: add warning and known issue for
 v2021.1.x x86 upgrade

---
 docs/releases/v2023.1.rst | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/docs/releases/v2023.1.rst b/docs/releases/v2023.1.rst
index d181f7f12..f091a71e5 100644
--- a/docs/releases/v2023.1.rst
+++ b/docs/releases/v2023.1.rst
@@ -7,6 +7,11 @@ Important notes
 Upgrades to v2023.1 and later releases are only supported from releases v2021.1 and later.
 This is due to migrations that have been removed to simplify maintenance.
 
+**Note:**
+Due to a bug, configuration is lost on upgrades from Gluon v2021.1.x on the *x86-64*,
+*x86-generic* and *x86-legacy* targets, returning nodes to config mode. If your
+network is still running a Gluon version older than v2022.1, it is recommended to
+skip v2023.1 and wait for the v2023.1.1 release.
 
 Added hardware support
 ----------------------
@@ -95,9 +100,13 @@ Bugfixes
 Minor changes
 -------------
 
-- Images built for the ``x86`` targets are now natively bootable on
+- .. rst-class:: strike
+
+  Images built for the ``x86`` targets are now natively bootable on
   EFI systems without CSM or BIOS support modes.
 
+  EFI support was found to break upgrades from Gluon v2021.1.x. It will be removed from
+  v2023.1.x to be reintroduced in a later release.
 
 Known issues
 ------------
@@ -120,3 +129,7 @@ Known issues
   (`#496 <https://github.com/freifunk-gluon/gluon/issues/496>`_)
 
   This may lead to issues in environments where a fixed MAC address is expected (like VMware when promiscuous mode is disallowed).
+
+* Configuration is lost on upgrades from Gluon v2021.1.x on the *x86-64*, *x86-generic* and *x86-legacy* targets,
+  returning nodes to config mode
+  (`#2967 <https://github.com/freifunk-gluon/gluon/issues/2967>`_)
-- 
GitLab