From 49aff1086846fe872e5868f8e21cb47c8bc22fe8 Mon Sep 17 00:00:00 2001
From: Andrew Sayre <6730289+andrewsayre@users.noreply.github.com>
Date: Sat, 20 Apr 2019 20:40:28 -0500
Subject: [PATCH] Add debug info and cleanup (#9263)

---
 source/_components/heos.markdown | 27 ++++++++++++++++++++-------
 1 file changed, 20 insertions(+), 7 deletions(-)

diff --git a/source/_components/heos.markdown b/source/_components/heos.markdown
index eb6c3687e88..3c059b100c4 100644
--- a/source/_components/heos.markdown
+++ b/source/_components/heos.markdown
@@ -1,6 +1,6 @@
 ---
 layout: page
-title: "Denon HEOS speakers"
+title: "Denon HEOS"
 description: "Instructions on how to integrate Denon HEOS into Home Assistant."
 date: 2019-03-06 22:00
 sidebar: true
@@ -13,13 +13,13 @@ ha_release: 0.92
 ha_iot_class: Local Push
 ---
 
-The HEOS component integrates [HEOS](http://heosbydenon.denon.com) capable products, such as speakers, amps, and receivers (Denon and Marantz) into Home Assistant. Features currently include:
+The HEOS integration adds support for [HEOS](http://heosbydenon.denon.com) capable products, such as speakers, amps, and receivers (Denon and Marantz) into Home Assistant. Features currently include:
 
 - Each device is represented as a media player entity
 - View the currently playing media
-- Control play mode (play, pause, stop), volume, and mute
-- Clear playlist support
-- Play previous and next tracks
+- Control play mode (play, pause, stop, next and previous), volume, mute and shuffle
+- Clear playlist
+- Select source from device physical inputs and HEOS favorites
 
 
 ## {% linkable_title Configuration %}
@@ -40,10 +40,23 @@ host:
 {% endconfiguration %}
 
 <p class='note info'>
-A connection to a single device enables control for all devices in the HEOS account. If you have multiple HEOS devices, enter the host of one that is connected to the LAN via wire or has the strongest wireless signal.
+A connection to a single device enables control for all devices on the network. If you have multiple HEOS devices, enter the host of one that is connected to the LAN via wire or has the strongest wireless signal.
 </p>
 
 ## {% linkable_title Notes %}
 
 - HEOS groups are not currently supported.
-- Receivers with multiple zones are represented as a single media player. They can be turned on, but not off by this integration.
+- Receivers with multiple zones are represented as a single media player. They will be turned on when playback is started, but cannot be turned off by the integration at this time.
+
+
+## {% linkable_title Debugging %}
+
+The HEOS component will log additional information about commands, events, and other messages when the log level is set to `debug`. Add the the relevent line below to the `configuration.yaml` to enable debug logging:
+
+```yaml
+logger:
+  default: info
+  logs:
+    homeassistant.components.heos: debug
+    pyheos: debug
+```
\ No newline at end of file