From 9cff4f67c9dd3258d4650ddadf8f1d4096a6e007 Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Wed, 3 May 2023 14:46:46 +0200
Subject: [PATCH] List supported and deprecated intents in introduction (#1765)

* List supported and deprecated intents in introduction

- in case people do not scroll and don't realize there are deprecated intents there.
- It should also make it more obvious that currently only 4 intents are used.

* Built-in intents: expand introduction to give more context

* built-in intents: fix formatting
---
 docs/intent_builtin.md | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/docs/intent_builtin.md b/docs/intent_builtin.md
index af6656bf..c37f3d6a 100644
--- a/docs/intent_builtin.md
+++ b/docs/intent_builtin.md
@@ -5,7 +5,32 @@ toc_max_heading_level: 2
 
 import intents from '!!yaml-loader!../intents/intents.yaml';
 
-The following intents are supported by Home Assistant:
+The following intents are **supported**:
+
+  * HassTurnOn, HassTurnOff, HassGetState, HassLightSet
+
+The following intents are **deprecated**:
+
+ * HassOpenCover, HassCloseCover, HassToggle, HassHumidifierSetpoint, HassHumidifierMode, HassShoppingListAddItem, HassShoppingListLastItems
+
+**Slots**
+
+For *HassTurnOn* and *HassTurnOff*, the *slots* are optional. 
+
+Possible slot combinations are:
+
+
+    | Slot combination        | Example                          |
+    | ----------------------- | ---------------------------------|
+    | name only               | table light                      |
+    | area only               | kitchen                          |
+    | area and name           | living room reading light        |
+    | area and domain         | kitchen lights                   |
+    | area and device class   | bathroom humidity                |
+    | device class and domain | carbon dioxide sensors           |
+
+
+## Supported intents
 
 <>
 {