From 0ae7a6c438d153b9ba914e104da4c13ac84ce88a Mon Sep 17 00:00:00 2001
From: Klaas Schoute <klaas_schoute@hotmail.com>
Date: Thu, 25 Oct 2018 09:38:12 +0200
Subject: [PATCH] Update Pushbullet sensor component configuration (#7067)

* Update Pushbullet sensor component configuration

* Minor changes
---
 source/_components/sensor.pushbullet.markdown | 57 +++++++++++++------
 1 file changed, 39 insertions(+), 18 deletions(-)

diff --git a/source/_components/sensor.pushbullet.markdown b/source/_components/sensor.pushbullet.markdown
index bd8ee0eda5a..8d516949e9e 100644
--- a/source/_components/sensor.pushbullet.markdown
+++ b/source/_components/sensor.pushbullet.markdown
@@ -13,11 +13,16 @@ ha_release: 0.44
 ha_iot_class: "Cloud Polling"
 ---
 
-The `pushbullet` sensor platform reads messages from [Pushbullet](https://www.pushbullet.com/), a free service to send information between your phones, browsers, and friends.
-This sensor platform provides sensors that show the properties of the latest received Pushbullet notification mirror.
+The `pushbullet` sensor platform reads messages from [Pushbullet](https://www.pushbullet.com/), a free service to send information between your phones, browsers, and friends. This sensor platform provides sensors that show the properties of the latest received Pushbullet notification mirror.
+
+## {% linkable_title Setup %}
 
 Notification Mirroring allows users to see their Android device's notifications on their computer. It must be first enabled in the app and is currently only available on the Android platform. For more information, please see [this announcement](https://blog.pushbullet.com/2013/11/12/real-time-notification-mirroring-from-android-to-your-computer/) on the Pushbullet Blog.
 
+Go to [https://www.pushbullet.com/#settings/account](https://www.pushbullet.com/#settings/account) to retrieve your API key/access token.
+
+## {% linkable_title Configuration %}
+
 To enable the Pushbullet sensor in your installation, add the following to your `configuration.yaml` file:
 
 ```yaml
@@ -29,21 +34,37 @@ sensor:
       - body
 ```
 
-Configuration variables:
+{% configuration %}
+api_key:
+  description: Your Pushbullet API key.
+  required: true
+  type: string
+monitored_conditions:
+  description: Properties of the push to monitor.
+  required: false
+  default: "`body` and `title`"
+  type: list
+  keys:
+    application_name:
+      description: The application sending the push.
+    body:
+      description: Body of the message.
+    notification_id:
+      description: ID of the notification.
+    notification_tag:
+      description: Tag (if the application sending supports it).
+    package_name:
+      description: Name of the sender's package.
+    receiver_email:
+      description: The email of the push's target.
+    sender_email:
+      description: The sender of the push.
+    source_device_iden:
+      description: ID of the sender's device.
+    title:
+      description: Title of the push.
+    type:
+      description: Type of push.
+{% endconfiguration %}
 
-- **api_key** (*Required*): Enter the API key for Pushbullet. Go to [https://www.pushbullet.com/#settings/account](https://www.pushbullet.com/#settings/account) to retrieve your API key/access token.
-
-- **monitored_conditions** array (*Optional*): Properties of the push to monitor.  Defaults to `body` and `title`.
-  - **application_name**: The application sending the push.
-  - **body**: Body of the message.
-  - **notification_id**: ID of the notification.
-  - **notification_tag**: Tag (if the application sending supports it).
-  - **package_name**: Name of the sender's package.
-  - **receiver_email**: The email of the push's target.
-  - **sender_email**: The sender of the push.
-  - **source_device_iden**: ID of the sender's device.
-  - **title**: Title of the push.
-  - **type**: Type of push.
-  
- 
 All properties will be displayed as attributes. The properties array are just for logging the sensor readings for multiple properties.