Merge branch 'current' into next

Gemfile.lock

@@ -28,7 +28,7 @@ GEM
     eventmachine (1.2.7)
     ffi (1.17.0-x86_64-linux-gnu)
     forwardable-extended (2.6.0)
-    google-protobuf (4.27.1-x86_64-linux)
+    google-protobuf (4.27.2-x86_64-linux)
       bigdecimal
       rake (>= 13)
     http_parser.rb (0.8.0)
@@ -130,8 +130,9 @@ GEM
     ruby2_keywords (0.0.5)
     safe_yaml (1.0.5)
     sass (3.4.25)
-    sass-embedded (1.77.5-x86_64-linux-gnu)
+    sass-embedded (1.77.5)
       google-protobuf (>= 3.25, < 5.0)
+      rake (>= 13)
     sass-globbing (1.1.5)
       sass (>= 3.1)
     sassc (2.1.0-x86_64-linux)
@@ -142,7 +143,7 @@ GEM
       rack-protection (= 4.0.0)
       rack-session (>= 2.0.0, < 3)
       tilt (~> 2.0)
-    sorbet-runtime (0.5.11444)
+    sorbet-runtime (0.5.11447)
     stringex (2.8.6)
     strscan (3.1.0)
     terminal-table (3.0.2)

source/_docs/troubleshooting_general.markdown

@@ -47,3 +47,13 @@ If your Home Assistant is acting up and you cannot identify a root cause, you ca
 - If you cannot reach the UI, you can enable **Safe mode** from the [command line](/common-tasks/os/#home-assistant-via-the-command-line):
   - ```ha core restart --safe-mode```
 
+## I don't see any updates
+
+Typically, updates are shown at the top of the **Settings** page. If you don't see them there, the **Visibility** option might be disabled.
+
+### Resolution
+
+1. On the **System** page, in the top-right corner, select the three dots menu and select **Check for updates**.
+2. Go to {% my updates title="**System** > **Updates**" %}.
+    - Select the update notification.
+    - Select the cogwheel, then set **Visible** to active.

source/_includes/asides/docs_navigation.html

@@ -25,7 +25,7 @@
       <li>
         <b>{% active_link /docs/frontend/ Frontend %}</b>
         <ul>
-          <li>{% active_link /dashboards Dashboards & views %}</li>
+          <li>{% active_link /dashboards Dashboards, views, cards %}</li>
           <li>{% active_link /docs/organizing/ Organizing: areas, floors, labels, categories, ... %}</li>
           <li>{% active_link /docs/frontend/icons/ Icons%}</li>
         </ul>

source/_includes/common-tasks/beta_version.md

@@ -14,6 +14,11 @@ If you would like to test next release before anyone else, you can install the b
     3. Select **Join beta**.
     4. Go to the {% my configuration title="**Configuration**" %} panel.
     5. Install the update that is presented to you.
+       - **Troubleshooting**: If you do not see that notification:
+         - In the top right corner, select the three dots menu and select **Check for updates**.
+         - Go to {% my updates title="**System** > **Updates**" %}.
+           - Select the update notification.
+           - Select the cogwheel, then set **Visible** to active.
 
 - title: From the CLI
   content: |

source/_includes/common-tasks/update.md

@@ -20,8 +20,11 @@ To update Home Assistant Core when you run Home Assistant {{ page.installation_n
     1. Open your Home Assistant UI.
     2. Navigate to the **Settings** panel.
     3. On the top you will be presented with an update notification.
-
-    _If you do not see that notification you can click the overflow menu in the top right and select "Check for updates"._
+       - **Troubleshooting**: If you do not see that notification:
+         - In the top right corner, select the three dots menu and select **Check for updates**.
+         - Go to {% my updates title="**System** > **Updates**" %}. 
+           - Select the update notification.
+           - Select the cogwheel, then set **Visible** to active.
 
 - title: Using the CLI
   content: |

source/_integrations/zha.markdown

@@ -538,7 +538,7 @@ Note that submitting a new "device support request" does not guarantee that some
 
 ### Best practices to avoid pairing/connection difficulties
 
-If you are having problems pairing a device to then ZHA integratuon then it is recommomended to verify that you try to follow recommended best practices to avoid pairing and/or connection issues:
+If you experience problems pairing a device, verify that you follow best practices to avoid pairing/connection issues:
 
 - Check that your setup and environment are optimized to avoid interference.
   - As interference avoidance is an extremely important topic on its own, please read and follow the tips in the separate section below about Zigbee interference avoidance and network range/coverage optimization.