Improve Alexa Smart Home Documentation. (home-assistant#11851)

Improve Alexa Smart Home Documentation.
bictorv · Jan 29, 2020 · 6fe4759 · 6fe4759
2 parents 74d8fec + dff09c5
commit 6fe4759
Show file tree

Hide file tree

Showing 7 changed files with 720 additions and 52 deletions.
diff --git a/source/_integrations/alexa.markdown b/source/_integrations/alexa.markdown
@@ -21,9 +21,12 @@ For Home Assistant Cloud Users, documentation can be found [here](https://www.na
 
 There are a few ways that you can use Amazon Alexa and Home Assistant together.
 
-- [Build custom commands](/integrations/alexa.intent/)
+- [Create an Alexa Smart Home Skill to control lights, etc.](/integrations/alexa.smart_home/)
+  - Supports utterances without requiring the skill name, such as "Alexa, turn off the light."
+  - Support for controlling devices through Alexa routines.
+  - Support for viewing and controlling devices with the Alexa mobile app.
+- [Create a Custom Alexa Skill to build custom commands](/integrations/alexa.intent/)
 - [Create a new Flash Briefing source](/integrations/alexa.flash_briefings/)
-- [Use the Smart Home API to control lights, etc.](/integrations/alexa.smart_home/)
 - Alternative: use the [Emulated Hue integration][emulated-hue-component] to trick Alexa into thinking Home Assistant is a Philips Hue hub.
 
 ### Requirements

diff --git a/source/_integrations/alexa.smart_home.markdown b/source/_integrations/alexa.smart_home.markdown
diff --git a/source/images/integrations/alexa/alexa_app_cover_position.png b/source/images/integrations/alexa/alexa_app_cover_position.png
diff --git a/source/images/integrations/alexa/alexa_app_doorbell_announcement.png b/source/images/integrations/alexa/alexa_app_doorbell_announcement.png
diff --git a/source/images/integrations/alexa/alexa_app_garage_door_pin.png b/source/images/integrations/alexa/alexa_app_garage_door_pin.png
diff --git a/source/images/integrations/alexa/alexa_app_person_detection.png b/source/images/integrations/alexa/alexa_app_person_detection.png
diff --git a/source/images/integrations/alexa/alexa_app_security_system_pin.png b/source/images/integrations/alexa/alexa_app_security_system_pin.png