Merge pull request #82 from chrizzo-hb/main

Improved update instructions

Author: chrizzo-hb

docs/play/update.de.md

@@ -1,11 +1,28 @@
 #  :material-update: KNULLI aktualisieren
 
+Wenn du KNULLI aktualisieren möchtest, hast du normalerweise zwei Möglichkeiten:
+
+* Du kannst KNULLI **erneut flashen** um eine saubere Installation der neuen Version zu bekommen
+* Du kannst KNULLI manuell aktualisieren, in dem du das neueste **Boot-Package** aufspielst
+
+Sei dir bitte bewusst, dass wir **Boot-Packages** ausschließlich für **kleine Updates** bereitstellen. Wenn du ein **größeres Update** installieren möchtest, enthält es in der Regel so viele **schwerwiegende Änderungen**, dass ein erneutes Flashen zwingend erforderlich ist.
+
+## Größere Updates
+
+Größere KNULLI-Updates (z.B. das Update von **20240721** auf **Firefly**) erfordern zwingend, dass die KNULLI-CFW erneut geflasht wird und alle deine **Einstellungen zurückgesetzt** werden. Dementsprechend werden größeren KNULLI-Updates von vornherein ganz bewusst keine **Boot-Packages** beigelegt. Wenn du ein größeres KNULLI-Update installieren möchtest, empfehlen wir dir dringend, vorher eine Sicherheitskopie deines  [userdata-Ordners](../add-games/game-storage) zu machen. Falls du ein Dual-SD-Karten-Setup verwendest **musst** du zusätzlich auch den `system`-Ordner aus deinem [userdata-Ordner](../add-games/game-storage) entfernen, damit KNULLI ihn erneut anlegen und dabei alle neuen Standardeinstellungen für dich setzen kann. Nach Abschluss deiner KNULLI-Neuinstallation kannst du dann deine Daten aus der Sicherungskopie wiederherstellen.
+
+Falls du weitere Hilfe dabei brauchst, ein größeres Update zu installieren, solltest du einen Blick auf den [Major-Updates-Guide](../../guides/major-updates) werfen.
+
+!!! danger "Der system-Ordner"
+
+    Nach einem größeren Update solltest du **niemals den `system`-Ordner einer vorherigen Version wiederherstellen**. Wenn du genau weißt, was du tust, kannst du möglicherweise einzelne Einstellungen (z.B. remap-Dateien) aus deinem alten `system`-Ordner übernehmen. Du solltest dir aber darüber im Klaren sein, dass durch das Update neue Optionen hinzugefügt und alte entfernt oder umbenannt wurden. Es ist **extrem** wahrscheinlich, dass es zu Fehlern und Problemen führt, wenn du versuchst, die neue KNULLI-Version mit den alten Eintellungen zu verwenden.
+
+## Kleine Updates
+
 !!! info "OTA-Updates"
 
     Batocera unterstützt OTA-Updates (over-the-air), die direkt aus der EmulationStation-GUI heraus gestartet werden können. Auch KNULLI zeigt dir bereits das OTA-Update-Menü an. Leider haben wir aber **noch keine OTA-Server** eingerichtet. Bis wir das getan haben, müssen wir dich leider bitten, dein KNULLI-Gerät **manuell** zu aktualisieren.
 
-## Manuelles Update
-
 Du kannst die KNULLI-Installation auf deinem Gerät aktualisieren, indem du das neueste **Boot-Package** für dein Gerät herunterlädst und manuell die `batocera`-Datei auf deinem Gerät ersetzt.
 
 1. Lade das aktuelle **Boot-Package** für dein Gerät von unserer [Releases-Seite](https://github.com/knulli-cfw/distribution/releases/latest) herunter, indem du den folgenden Schritten folgst:
@@ -24,6 +41,6 @@ Du kannst die KNULLI-Installation auf deinem Gerät aktualisieren, indem du das
     * **Benenne** die datei `batocera.update` in `batocera` **um**.
 5. Starte das Gerät erneut, um mit dem Updatevorgang zu beginnen!
 
-!!! danger "Re-creating default settings"
+!!! danger "Standardeintstellungen wiederherstellen"
 
-     **Normalerweise** erfordern KNULLI-Updates **NICHT** dass du einzelne Dateien oder gar den ganzen `system`-Ordner auf Werkseinstellungen zurücksetzt. In **SEHR seltenen Fällen** kann es allerdings nötig sein, deine Einstellungen an neue KNULLI-Standardeinstellungen anzupassen. In diesen Fällen ist es häufig am einfachsten, die entsprechenden Werkseinstellungen wiederherzustellen, entweder in dem man einzelne Dateien oder ganze Ordner zurücksetzt. Du kannst mehr über das Thema im Abschnitt [Werkseinstellungen](../../configure/reset-to-factory-settings) erfahren. Du solltest dies aber **NIEMALS** tun, wenn du dir nicht absolut sicher bist, dass es notwendig ist!
+     **Normalerweise** erfordern kleinere KNULLI-Updates **NICHT** dass du einzelne Dateien oder gar den ganzen `system`-Ordner auf Werkseinstellungen zurücksetzt. In **SEHR seltenen Fällen** kann es allerdings nötig sein, deine Einstellungen an neue KNULLI-Standardeinstellungen anzupassen. In diesen Fällen ist es häufig am einfachsten, die entsprechenden Werkseinstellungen wiederherzustellen, entweder in dem man einzelne Dateien oder ganze Ordner zurücksetzt. Du kannst mehr über das Thema im Abschnitt [Werkseinstellungen](../../configure/reset-to-factory-settings) erfahren. Du solltest dies aber **NIEMALS** tun, wenn du dir nicht absolut sicher bist, dass es notwendig ist!

docs/play/update.md

@@ -1,11 +1,28 @@
 #  :material-update: Updating KNULLI
 
+If you want to update KNULLI, you usually have two options:
+
+* **Re-flash** KNULLI to get a clean installation of the new version
+* Manually update KNULLI by replacing the **boot package**
+
+Please be aware that only **minor updates** come with a **boot package**. If you want to install a **major update**, it usually contains so many **significant changes** that re-flashing KNULLI is mandatory.
+
+## Major Updates
+
+Major KNULLI updates (e.g., the update from **20240721** to **Firefly**) require a full re-flash of the KNULLI CFW and a full reset of all your **settings**. Consequently, major KNULLI updates purposely do **not** come with a boot package. If you want to install a major KNULLI update, we strongly recommend to create a backup of your [userdata folder](../add-games/game-storage) before you re-flash. Furthermore, if you run a Dual-SD-Card setup, you **must** remove your `system` folder from your [userdata folder](../add-games/game-storage) so that KNULLI can create a new one with all the new default settings. Once the new KNULLI version is up and running, you will be able to restore the backup by putting all your files back.
+
+If you need more help installing a major update, have a look at our [Major Updates Guide](../../guides/major-updates).
+
+!!! danger "The system folder"
+
+    After a major update, please **do not restore the `system` folder** from your previous installation. If you know what you are doing, you can cherry-pick certain settings (e.g., remap files). However, you should be aware that major updates sometimes have options added, removed, or renamed. Relying on your old settings is **extremely** likely to cause problems.
+
+## Minor Updates
+
 !!! info "OTA Updates"
 
     Batocera supports OTA (over-the-air) updates which can be executed directly from the EmulationStation GUI. Consequently, KNULLI also shows the OTA update menu. However, currently, we do **not have OTA servers** set up, yet. Until we do, we kindly ask you to update your KNULLI installation **manually**.
 
-## Manual Update
-
 KNULLI can be updated by downloading the **boot package** for your device and replacing the `batocera` file manually.
 
 1. Download the latest **boot package** for your device from our [Releases page](https://github.com/knulli-cfw/distribution/releases/latest) by following these steps:
@@ -26,4 +43,4 @@ KNULLI can be updated by downloading the **boot package** for your device and re
 
 !!! danger "Re-creating default settings"
 
-     **Usually**, KNULLI updates will **NOT** require you to re-create neither a single configuration file nor your entire `system` folder. However, in **VERY rare cases** it might be required to adapt your configuration to new KNULLI default settings. In those cases, the easiest way is to reset to factory settings, either by re-creating single files or sometimes the entire `system` folder. You can learn more about it in the [Reset to factory settings](../../configure/reset-to-factory-settings) section, however, do **NOT** do this, unless you are absolutely sure it is required!
+     **Usually**, minor KNULLI updates will **NOT** require you to re-create neither a single configuration file nor your entire `system` folder. However, in **VERY rare cases** it might be required to adapt your configuration to new KNULLI default settings. In those cases, the easiest way is to reset to factory settings, either by re-creating single files or sometimes the entire `system` folder. You can learn more about it in the [Reset to factory settings](../../configure/reset-to-factory-settings) section, however, do **NOT** do this, unless you are absolutely sure it is required!