From d541bb0d12b53224b3750a1f23147b49e5739723 Mon Sep 17 00:00:00 2001
From: Michael Hansen <mike@rhasspy.org>
Date: Thu, 5 Sep 2024 15:15:04 -0500
Subject: [PATCH 1/2] Document assist_satellite integration

---
 .../_integrations/assist_satellite.markdown   | 45 +++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 source/_integrations/assist_satellite.markdown

diff --git a/source/_integrations/assist_satellite.markdown b/source/_integrations/assist_satellite.markdown
new file mode 100644
index 000000000000..2cce744d97f5
--- /dev/null
+++ b/source/_integrations/assist_satellite.markdown
@@ -0,0 +1,45 @@
+---
+title: Assist Satellite
+description: Remote satellites that use Assist.
+ha_category:
+  - Voice
+ha_release: '2024.10'
+ha_codeowners:
+  - '@balloob'
+  - '@synesthesiam'
+ha_domain: assist_satellite
+ha_integration_type: entity
+ha_quality_scale: internal
+---
+
+Platform for remote satellites that use [Assist](/voice_control/) to control and interact with Home Assistant. This {% term integration %} allows other integrations to represent these satellites in a consistent manner.
+
+{% include integrations/building_block_integration.md %}
+
+## Actions
+
+An Assist satellite entity exposes additional actions to remotely control the satellite in automations or scripts. These actions can be created via the UI, but are
+also available in YAML (examples below).
+
+### Action `assist_satellite.announce`
+
+The {% my developer_call_service service="assist_satellite.announce" %} action announces a message or media id on the satellite. If a message is to be announced, it will first be converted to a media id using the [text-to-speech](/integrations/tts) system of the satellite's configured [pipeline](/voice_control/voice_remote_local_assistant/).
+
+
+{% my developer_call_service badge service="assist_satellite.announce" %}
+
+Examples in YAML:
+
+```yaml
+action: assist_satellite.announce
+target:
+  entity_id: assist_satellite.my_entity
+  message: "Dinner is ready!"
+```
+
+```yaml
+action: assist_satellite.announce
+target:
+  entity_id: assist_satellite.my_entity
+  media_id: ITEM_ID
+```

From 93dd1acb6dfab5fe011a4b9d3c4606de33c2f4bd Mon Sep 17 00:00:00 2001
From: Michael Hansen <mike@rhasspy.org>
Date: Wed, 18 Sep 2024 13:38:21 -0500
Subject: [PATCH 2/2] Incorporate feedback

---
 source/_integrations/assist_satellite.markdown | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/source/_integrations/assist_satellite.markdown b/source/_integrations/assist_satellite.markdown
index 2cce744d97f5..4b5e4f805830 100644
--- a/source/_integrations/assist_satellite.markdown
+++ b/source/_integrations/assist_satellite.markdown
@@ -5,14 +5,14 @@ ha_category:
   - Voice
 ha_release: '2024.10'
 ha_codeowners:
-  - '@balloob'
+  - '@home-assistant/core'
   - '@synesthesiam'
 ha_domain: assist_satellite
 ha_integration_type: entity
 ha_quality_scale: internal
 ---
 
-Platform for remote satellites that use [Assist](/voice_control/) to control and interact with Home Assistant. This {% term integration %} allows other integrations to represent these satellites in a consistent manner.
+This is an {% term integration %} for remote satellites that use [Assist](/voice_control/) to control and interact with Home Assistant. This allows other integrations to represent these satellites in a consistent manner.
 
 {% include integrations/building_block_integration.md %}