From 9d13c99849b109f2e8dc99d67e3bb1462fa8ad4b Mon Sep 17 00:00:00 2001
From: Nicholas Westerhausen <nwesterhausen@gmail.com>
Date: Sat, 13 Oct 2018 16:30:15 -0400
Subject: [PATCH] dovado sensor configuration variable format (#6700)

* Update configuration variable for dovado

Update configuration variable format.
Remove two optional configurations from the example configuration.

Section underneath configuration variable has a list of allowed values for the *sensors* array there. I am not sure how to describe this using the configuration block format. Possibly related to home-assistant/developers.home-assistant/issues/107

* Change format of accepted keys

Change format of accepted keys to pattern seen in other components.
Move additional information about the component (registering an SMS notifier) up to the top of the document.

* Minor changes
---
 source/_components/sensor.dovado.markdown | 53 +++++++++++++++--------
 1 file changed, 36 insertions(+), 17 deletions(-)

diff --git a/source/_components/sensor.dovado.markdown b/source/_components/sensor.dovado.markdown
index bbbd0bae3c5..d862ef3fef3 100644
--- a/source/_components/sensor.dovado.markdown
+++ b/source/_components/sensor.dovado.markdown
@@ -13,7 +13,7 @@ ha_release: 0.32
 ha_iot_class: "Local Polling"
 ---
 
-The `dovado` platform let you monitor your router from [Dovado](http://www.dovado.com/)
+The `dovado` platform let you monitor your router from [Dovado](http://www.dovado.com/). If the router provides SMS functionality, a service for sending SMS will also be registered in Home Assistant.
 
 To add a Dovado sensor to your installation, add the following to your `configuration.yaml` file:
 
@@ -23,23 +23,42 @@ sensor:
   - platform: dovado
     username: YOUR_USERNAME
     password: YOUR_PASSWORD
-    host: IP_ADDRESS
-    port: PORT
     sensors:
       - network
 ```
 
-Configuration variables:
-
-- **username** (*Required*): Your username.
-- **password** (*Required*): Your password.
-- **host** (*Optional*): The IP address of your router, e.g., `192.168.1.1`. If no host is provided, the gateway for the same network as Home Assistant will automatically be used.
-- **port** (*Optional*): The port number of your router, e.g., `999`. If no port is provided, the default API port (6435) will be used.
-- **sensors** array (*Required*): Conditions to display in the frontend.
-  - **network**: Network state (3G, 4G, etc).
-  - **signal**: The signal strength (%).
-  - **download**: The download speed.
-  - **upload**: The upload speed.
-  - **sms**: Number of unread text messages
-
-If the router provides SMS functionality, a service for sending SMS will also be registered in Home Assistant.
+{% configuration %}
+username:
+  description: Your Dovado username.
+  required: true
+  type: string
+password:
+  description: Your Dovado password.
+  required: true
+  type: string
+host:
+  description: The IP address of your router.
+  required: false
+  type: string
+  default: Home Assistant's default gateway
+port:
+  description:  The port number of your router.
+  required: false
+  type: integer
+  default: 6435
+sensors:
+  description: Conditions to display in the frontend. Only accepts the values listed here.
+  required: true
+  type: list
+  keys:
+    network:
+      description: Creates a sensor for Network State (3G, 4G, etc.).
+    signal:
+      description: Creates a sensor for the signal strength.
+    download:
+      description: Creates a sensor for download speed.
+    upload:
+      description: Creates a sensor for download speed.
+    sms:
+      description: Creates a sensor for number of unread text messages.
+{% endconfiguration %}