Add documentation for the Garmin Connect integration

.github/copilot-instructions.md

@@ -71,7 +71,7 @@ Some other rules:
 - Use the word "Home Assistant" in full, and not "HA" or "HASS". 
 - Use sentence-style capitalization for headings and titles.
 - Use **bold** to mark up UI strings. For example:
-    - Under **Settings** > **Devices & Services**, select **Integrations**.
+    - Under **Settings** > **Devices & services**, select **Integrations**.
 - Do not use "e.g.", "i.e.", "etc.", or "etcetera". Use "like", "for example",
   or "such as" instead.
 - Lists

Gemfile

@@ -10,7 +10,7 @@ group :development do
   gem 'stringex', '2.8.6'
   # > 2.1.0 causes slowdowns https://github.com/sass/sassc-ruby/issues/189
   gem 'sassc', '2.1.0'
-  gem 'sass-embedded', '1.97.1'
+  gem 'sass-embedded', '1.97.2'
   gem 'rubocop', '1.82.1'
   gem 'ruby-lsp', '0.26.4'
   gem 'rackup', '2.3.1'

Gemfile.lock

@@ -27,8 +27,8 @@ GEM
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)
     eventmachine (1.2.7)
-    ffi (1.17.2-arm64-darwin)
-    ffi (1.17.2-x86_64-linux-gnu)
+    ffi (1.17.3-arm64-darwin)
+    ffi (1.17.3-x86_64-linux-gnu)
     forwardable-extended (2.6.0)
     google-protobuf (4.33.2-arm64-darwin)
       bigdecimal
@@ -97,7 +97,7 @@ GEM
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
     prism (1.7.0)
-    public_suffix (7.0.0)
+    public_suffix (7.0.2)
     racc (1.8.1)
     rack (3.2.4)
     rack-protection (4.2.1)
@@ -118,7 +118,7 @@ GEM
       logger
     regexp_parser (2.11.3)
     rexml (3.4.4)
-    rouge (4.6.1)
+    rouge (4.7.0)
     rubocop (1.82.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
@@ -141,9 +141,9 @@ GEM
     ruby2_keywords (0.0.5)
     safe_yaml (1.0.5)
     sass (3.4.25)
-    sass-embedded (1.97.1-arm64-darwin)
+    sass-embedded (1.97.2-arm64-darwin)
       google-protobuf (~> 4.31)
-    sass-embedded (1.97.1-x86_64-linux-gnu)
+    sass-embedded (1.97.2-x86_64-linux-gnu)
       google-protobuf (~> 4.31)
     sass-globbing (1.1.5)
       sass (>= 3.1)
@@ -185,7 +185,7 @@ DEPENDENCIES
   rake (= 13.3.1)
   rubocop (= 1.82.1)
   ruby-lsp (= 0.26.4)
-  sass-embedded (= 1.97.1)
+  sass-embedded (= 1.97.2)
   sass-globbing (= 1.1.5)
   sassc (= 2.1.0)
   sinatra (= 4.2.1)

README.md

@@ -7,6 +7,16 @@
 
 This is the source for the [Home-Assistant.io website](https://home-assistant.io).
 
+## Access
+
+You can access the site at the following URLs, depending on the target branch:
+
+- **Production** (`current` branch): https://www.home-assistant.io
+- **Beta** (`rc` branch): https://rc.home-assistant.io
+- **Development** (`next` branch): https://next.home-assistant.io
+
+Additionally, Netlify provides a preview deployment for every pull request, linked in the first PR comment.
+
 ## Setup
 
 Setting up to contribute to documentation and the process for submitting pull requests is explained in the [developer documentation](https://developers.home-assistant.io/docs/documenting/).

package.json

@@ -17,7 +17,7 @@
     "remark-stringify": "^11.0.0",
     "textlint": "^15.5.0",
     "textlint-filter-rule-allowlist": "^4.0.0",
-    "textlint-filter-rule-comments": "^1.2.2",
+    "textlint-filter-rule-comments": "^1.3.0",
     "textlint-rule-common-misspellings": "^1.0.1",
     "textlint-rule-terminology": "^5.2.16"
   },

sass/homeassistant/pages/connect/zbt-2/components/_built-for-home-assistant.scss

@@ -39,6 +39,7 @@ section#built-for-home-assistant {
         flex-direction: column;
 
         @include bp(tablet) {
+            height: 100%;
             flex-direction: row;
         }
 
@@ -50,24 +51,10 @@ section#built-for-home-assistant {
             flex-grow: 1;
             flex-basis: 0;
 
-
             &:first-child {
-                height: -webkit-fill-available;
+                height: 100%;
                 position: relative;
 
-                &:before {
-                    @include bp(tablet) {
-                        content: '';
-                        position: absolute;
-                        top: calc(100% + 20px);
-                        left: 0;
-                        right: 0;
-                        height: 10rem;
-                        background-color: #000000;
-                        z-index: 1;
-                    }
-                }
-
                 img {
                     margin-top: -17.5%;
                     margin-bottom: -24px;

source/_data/glossary.yml

@@ -103,7 +103,7 @@
     automations or template entities based on the same blueprint, with each having its own
     configuration-specific settings. Blueprints are shared by the community on
     the [blueprints
-    exchange](https://community.home-assistant.io/c/blueprints-exchange/53) in
+    exchange](https://community.home-assistant.io/c/53) in
     the forum.
   link: /docs/blueprint/
   aliases:

source/_data/product/connect/zbt-2/faq.yml

@@ -6,18 +6,18 @@ items:
   - question: Why do I have to choose between Zigbee and Thread? Why not both?
     answer: 'Connect ZBT-2 cannot do both Zigbee and Thread simultaneously. This technology is often called “multiprotocol” or “MultiPAN”. Though it is theoretically possible with the hardware within Connect ZBT-2, in our experience, this functionality doesn’t work well, and we don’t plan to implement it. We previously thoroughly tested multiprotocol with our Connect ZBT-1 adapter and found its operation to be inconsistent, often causing device stability issues. We do not believe multiprotocol is suitable for operation in the home, and strongly recommend dedicating a device to each protocol.'
   - question: Can I migrate from my old adapter?
-    answer: 'Yes, we’ve put together easy migration wizards for both Zigbee and Thread, which help migrate the vast majority of adapters. Some adapters require extra steps before migrating to Connect ZBT-2 (for example, Conbee sticks require a specific firmware to facilitate the migration). Please visit our documentation for specific instructions on how to <a href="https://support.nabucasa.com/hc/en-us/sections/29400567268253" target="_blank">migrate your adapter</a>.'
+    answer: 'Yes, we’ve put together easy migration wizards for both Zigbee and Thread, which help migrate the vast majority of adapters. Some adapters require extra steps before migrating to Connect ZBT-2 (for example, Conbee sticks require a specific firmware to facilitate the migration). Please visit our documentation for specific instructions on how to <a href="https://support.nabucasa.com/hc/sections/29400567268253" target="_blank">migrate your adapter</a>.'
   - question: Why are you not using Power-over-Ethernet (PoE)?
     answer: 'Though PoE is a cool technology, we have focused this product on simplicity and peak performance. PoE has become easier to use and offers performance levels that make its convenience an appealing trade-off for many users, but it didn’t fit Connect ZBT-2’s design goals. PoE is something we continue to explore; in fact, we recently produced experimental firmware for our <a href="/blog/2025/10/13/portable-z-wave-with-wifi-and-poe/">Connect ZWA-2 adapter to operate over PoE</a>. We currently do not have plans to make a specific version of Connect ZBT-2 with built-in PoE, but we will look at other ways to have it work with PoE.'
   - question: What devices is it compatible with?
-    answer: 'If it is a Zigbee-certified device or Matter-certified device that uses Thread, it should work out of the box with Home Assistant. Home Assistant offers some of the strongest device compatibility of any smart home ecosystem. Some newer devices may require some configuration by our community, so it is best to <a href="https://community.home-assistant.io/c/hardware/22" target="_blank">check our community</a> for device compatibility.'
+    answer: 'If it is a Zigbee-certified device or Matter-certified device that uses Thread, it should work out of the box with Home Assistant. Home Assistant offers some of the strongest device compatibility of any smart home ecosystem. Some newer devices may require some configuration by our community, so it is best to <a href="https://community.home-assistant.io/c/22" target="_blank">check our community</a> for device compatibility.'
   - question: Does Connect ZBT-2 work with Matter?
-    answer: 'Yes, Home Assistant is officially Matter certified, and always works to support the latest versions, giving it great device compatibility. Some Matter devices use Wi-Fi, while others may use Thread (specifically battery-powered devices), and that’s when Connect ZBT-2 steps in to help you connect Matter devices. If you’re looking to add Matter devices that use Thread, follow our instructions to <a href="https://support.nabucasa.com/hc/en-us/articles/31347057208989" target="_blank">dedicate your device to Thread</a>.'
+    answer: 'Yes, Home Assistant is officially Matter certified, and always works to support the latest versions, giving it great device compatibility. Some Matter devices use Wi-Fi, while others may use Thread (specifically battery-powered devices), and that’s when Connect ZBT-2 steps in to help you connect Matter devices. If you’re looking to add Matter devices that use Thread, follow our instructions to <a href="https://support.nabucasa.com/hc/articles/31347057208989" target="_blank">dedicate your device to Thread</a>.'
   - question: Can Connect ZBT-2 be used as a repeater?
     answer: 'No, at the moment Connect ZBT-2 does not have this capability. This is technically possible, and we’ll explore enabling this, but there is no guarantee that this will happen.'
   - question: Can I use Connect ZBT-2 as a Thread border router separately from Home Assistant?
     answer: 'No, this capability is not built into Connect ZBT-2. There are several technical hurdles that would make this complex to implement, and more research is needed to see if this is possible.'
   - question: Why is Connect ZBT-2 so big?
     answer: 'The size is all about physics, and what’s needed to optimize its ability to transmit and receive the radio frequencies used by Zigbee and Thread (2.4 GHz). Both the antenna and base are the optimal size to maximize the adapter’s performance.'
   - question: Will you be supporting Zigbee 4.0?
-    answer: 'We’re reviewing the Zigbee 4.0 spec now, and we believe it should be possible to update Connect ZBT-2 to support this version. It would require the Zigbee firmware in Connect ZBT-2 to be updated, along with Home Assistant gaining support.'
+    answer: 'We’re reviewing the Zigbee 4.0 spec now, and we believe it should be possible to update Connect ZBT-2 to support this version. It would require the Zigbee firmware in Connect ZBT-2 to be updated, along with Home Assistant gaining support.'