From 2ed9a602cb2a7f3cacd531e783aeb305b347882a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Joakim=20S=C3=B8rensen?= <joasoe@gmail.com>
Date: Mon, 26 Sep 2022 18:46:39 +0200
Subject: [PATCH] Adjust the OS/Supervised docs for spesific version (#24234)

---
 source/_includes/common-tasks/beta_version.md        |  4 +++-
 source/_includes/common-tasks/development_version.md |  4 +++-
 source/_includes/common-tasks/specific_version.md    | 10 +++++++++-
 source/_includes/common-tasks/update.md              |  4 +++-
 4 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/source/_includes/common-tasks/beta_version.md b/source/_includes/common-tasks/beta_version.md
index e6e3f759574..651b2f33256 100644
--- a/source/_includes/common-tasks/beta_version.md
+++ b/source/_includes/common-tasks/beta_version.md
@@ -33,9 +33,11 @@ If you would like to test next release before anyone else, you can install the b
     3. Update Home Assistant core to the latest beta version
 
         ```bash
-        ha core update
+        ha core update --backup
         ```
 
+        _The_ `--backup` _flag here ensures that you have a partial backup of your current setup incase you need to downgrade._
+
 {% endtabbed_block %}
 
 {% elsif page.installation == "container" %}
diff --git a/source/_includes/common-tasks/development_version.md b/source/_includes/common-tasks/development_version.md
index 8c8d8cd5d2b..98483671822 100644
--- a/source/_includes/common-tasks/development_version.md
+++ b/source/_includes/common-tasks/development_version.md
@@ -25,9 +25,11 @@ If you want to stay on the bleeding-edge Home Assistant Core development branch,
 3. Update Home Assistant core to the latest dev version
 
     ```bash
-    ha core update
+    ha core update --backup
     ```
 
+    _The_ `--backup` _flag here ensures that you have a partial backup of your current setup incase you need to downgrade._
+
 {% elsif page.installation == "container" %}
 
 ```bash
diff --git a/source/_includes/common-tasks/specific_version.md b/source/_includes/common-tasks/specific_version.md
index f093bf13b5f..5be8aeab77e 100644
--- a/source/_includes/common-tasks/specific_version.md
+++ b/source/_includes/common-tasks/specific_version.md
@@ -2,14 +2,22 @@
 
 {% assign current_version = site.current_major_version | append: "." | append: site.current_minor_version | append: "." | append: site.current_patch_version  %}
 
+{% if page.installation != "os" and page.installation != "supervised" %}
+
 In the event that a Home Assistant Core version doesn't play well with your hardware setup, you can downgrade to a previous release. In this example `{{current_version}}` is used as the target version but you can choose the version you desire to run.
 
+{% endif %}
+
 {% if page.installation == "os" or page.installation == "supervised" %}
 
+You can use the CLI to upgrade to a specific version (`{{current_version}}` in this example), to downgrade your installation you should do a partial restore of a [backup](#backups) instead.
+
 ```bash
-ha core update --version {{current_version}}
+ha core update --version {{current_version}} --backup
 ```
 
+_The_ `--backup` _flag here ensures that you have a partial backup of your current setup incase you need to downgrade._
+
 {% elsif page.installation == "container" %}
 
 ```bash
diff --git a/source/_includes/common-tasks/update.md b/source/_includes/common-tasks/update.md
index 8959598f3e7..af01fb90445 100644
--- a/source/_includes/common-tasks/update.md
+++ b/source/_includes/common-tasks/update.md
@@ -29,9 +29,11 @@ To update Home Assistant Core when you run Home Assistant {{ page.installation_n
   content: |
 
     ```bash
-    ha core update
+    ha core update --backup
     ```
 
+    _The_ `--backup` _flag here ensures that you have a partial backup of your current setup incase you need to downgrade._
+
 {% endtabbed_block %}
 
 {% elsif page.installation == "container" %}