From 1bd9fb0e9cd5cf0ef5b34a0fe5c3b3298cd55179 Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Tue, 16 May 2023 21:41:49 +0200
Subject: [PATCH] Assist - add introductory overview topic (#27387)

* Assist - add introductory overview topic

- features 30min video introduction by BeardedTinker

* Update docs_navigation.html

Avoid unrelated change.
---
 source/_includes/asides/docs_navigation.html  |  1 +
 .../using_voice_assistants_overview.markdown  | 19 +++++++++++++++++++
 2 files changed, 20 insertions(+)
 create mode 100644 source/docs/assist/using_voice_assistants_overview.markdown

diff --git a/source/_includes/asides/docs_navigation.html b/source/_includes/asides/docs_navigation.html
index 487acf02ad5..f5df8571ce2 100644
--- a/source/_includes/asides/docs_navigation.html
+++ b/source/_includes/asides/docs_navigation.html
@@ -46,6 +46,7 @@
           <li>{% active_link /docs/assist/apple/ Assist for Apple devices %}</li>
           <li>{% active_link /docs/assist/builtin_sentences/ Built-in sentences %}</li>
           <li>{% active_link /docs/assist/custom_sentences/ Custom sentences %}</li>
+          <li>{% active_link /docs/assist/using_voice_assistants_overview/ Voice assistants - overview %}</li>
           <li>{% active_link /docs/assist/voice_remote_expose_devices/ Exposing devices to your voice assistant %}</li>
           <li>{% active_link /docs/assist/voice_remote_local_assistant/ Configuring a local assistant %}</li>
           <li>{% active_link /docs/assist/troubleshooting/ Troubleshooting Assist %}</li>
diff --git a/source/docs/assist/using_voice_assistants_overview.markdown b/source/docs/assist/using_voice_assistants_overview.markdown
new file mode 100644
index 00000000000..b0c164bf90a
--- /dev/null
+++ b/source/docs/assist/using_voice_assistants_overview.markdown
@@ -0,0 +1,19 @@
+---
+title: "Using voice assistants - overview"
+---
+
+We are in [chapter two](https://www.home-assistant.io/blog/2023/04/27/year-of-the-voice-chapter-2/) of Home Assistant's Year of the Voice.
+We can now turn speech into text and text back into speech. Wake word detection is not yet supported.
+
+The video below provides a good overview of what is currently possible with voice assistants. It shows you the following:
+
+* How to voice-control devices using the Assist button, an [analog phone](/projects/worlds-most-private-voice-assistant/), or an [ATOM Echo](/projects/thirteen-usd-voice-remote/).
+* How to [expose devices to Assist](/docs/assist/voice_remote_expose_devices/). 
+* How to set up a [local voice assistant](/docs/assist/voice_remote_local_assistant/). 
+* The video also shows the differences in processing speed. It compares:
+  * Home Assistant Cloud versus local processing,
+  * local processing on more or less powerful hardware.
+
+
+<lite-youtube videoid="MOJQU5zyoIY" videotitle="Local voice and hearing for your Home Assistant Assist"></lite-youtube>
+