From cb88cbc1a9bf52b09694a05199e6007583ab6449 Mon Sep 17 00:00:00 2001
From: Zac Holland <zacharyholland@gmail.com>
Date: Fri, 15 Dec 2023 16:24:03 -0800
Subject: [PATCH] put Readme update back to remove diff clutter

---
 readme.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/readme.md b/readme.md
index eb59e61..57b1484 100644
--- a/readme.md
+++ b/readme.md
@@ -57,6 +57,21 @@ $ steamos-readonly enable
 $ systemd-sysext merge
 ```
 
+## On system update
+
+Unfortunately, because SteamOS doesn't include a `SYSEXT_LEVEL`, this
+installation method breaks when the system version changes. Repair is simple:
+Re-run the second step of the installation, and everything should come back up
+as you had it.
+
+### Why this happens
+
+Extension images have to declare their compatibility using the OS ID and either
+the SYSEXT_LEVEL or VERSION_ID, which have to match what the system declares.
+
+SteamOS doesn't declare a SYSEXT_LEVEL, and the VERSION_ID increments with every
+system update, so there's no stable values to declare compatibility against.
+
 ## Common issues
 
 ### Broken config file