From 7193ed0b95d8dce0fb836ea1a28a497817edc9be Mon Sep 17 00:00:00 2001
From: Matthias Schiffer <mschiffer@universe-factory.net>
Date: Sat, 16 Sep 2023 21:33:52 +0200
Subject: [PATCH 1/2] docs: css: add .strike class

Add a custom CSS class to support strike-through text without depending on
a specific theme.
---
 docs/_static/css/custom.css | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/_static/css/custom.css b/docs/_static/css/custom.css
index c9996e0eea..5779a9dd2c 100644
--- a/docs/_static/css/custom.css
+++ b/docs/_static/css/custom.css
@@ -1,3 +1,7 @@
+.strike {
+	text-decoration: line-through;
+}
+
 /*
 	This fixes the vertical position of list markers when the first
 	element in the <li> is a <pre> block

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 2/2] 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 d181f7f12a..f091a71e56 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>`_)