From a1277a8cb6319220cc60c29e4febf27f7a7ac0f4 Mon Sep 17 00:00:00 2001
From: Fabian Affolter <mail@fabian-affolter.ch>
Date: Mon, 3 Sep 2018 10:21:56 +0200
Subject: [PATCH] Various fixes

---
 source/_components/netgear_lte.markdown       |  7 ++-
 .../_components/sensor.tank_utility.markdown  | 54 ++++++++++++-------
 2 files changed, 40 insertions(+), 21 deletions(-)

diff --git a/source/_components/netgear_lte.markdown b/source/_components/netgear_lte.markdown
index 36ce55a6fdc..3c407ce0686 100644
--- a/source/_components/netgear_lte.markdown
+++ b/source/_components/netgear_lte.markdown
@@ -9,17 +9,22 @@ sharing: true
 footer: true
 logo: netgear.png
 ha_release: 0.72
-ha_category: Other
+ha_category: Network
 ha_iot_class: "Local Polling"
 ---
 
 The Netgear LTE integration for Home Assistant allows you to observe and control [Netgear LTE modems](https://www.netgear.com/home/products/mobile-broadband/lte-modems/default.aspx), currently only tested with LB2120.
 
 The integration provides:
+
 * a notify service that will send an SMS
 * a sensor with the number of unread SMS messages in the inbox
 * a sensor with data usage
 
+## {% linkable_title Configuration %}
+
+To enable the component, add the following lines to your `configuration.yaml` file:
+
 ```yaml
 # Example configuration.yaml entry
 netgear_lte:
diff --git a/source/_components/sensor.tank_utility.markdown b/source/_components/sensor.tank_utility.markdown
index 061c66ab918..6446f5e8949 100644
--- a/source/_components/sensor.tank_utility.markdown
+++ b/source/_components/sensor.tank_utility.markdown
@@ -8,37 +8,51 @@ comments: false
 sharing: true
 footer: true
 logo: tank_utility.png
-ha_category: Sensor
+ha_category: Energy
 ha_release: "0.53"
 ---
 
 Add [Tank Utility](https://www.tankutility.com/) propane tank monitors to Home Assistant.
 
+## {% linkable_title Setup %}
+
+### {% linkable_title Authentication %}
+
+Authentication for the Tank Utility API is performed with the same email and password credentials used at [https://app.tankutility.com](https://app.tankutility.com).
+
+### {% linkable_title Devices %}
+
+Each item in the list of devices is a 24 character string. These values can be found by clicking on the **Usage Reports** link at the bottom of the graph on the [Tank Utility devices page](https://app.tankutility.com/#/devices).
+
+The device item value is the last segment of the URL path, e.g., the URL
+[https://app.tankutility.com/#/reports/000000000000000000000000](https://app.tankutility.com/#/reports/000000000000000000000000) would indicate `000000000000000000000000` as a device value.
+
+## {% linkable_title Configuration %}
+
+To enable the component, add the following lines to your `configuration.yaml` file:
+
 ```yaml
 # Example configuration.yaml entry
 sensor:
   - platform: tank_utility
-    email: EMAIL
-    password: PASSWORD
+    email: YOUR_EMAIL_ADDRESS
+    password: YOUR_PASSWORD
     devices:
       - 000000000000000000000000
 ```
 
-Configuration variables:
+{% configuration %}
+email:
+  description: "Your [https://app.tankutility.com](https://app.tankutility.com) email address."
+  required: true
+  type: string
+password:
+  description: "Your [https://app.tankutility.com](https://app.tankutility.com) password."
+  required: true
+  type: string
+unit_of_measurement:
+  description: All devices to monitor.
+  required: true
+  type: map
+{% endconfiguration %}
 
-* **email** *(Required)*: [https://app.tankutility.com](https://app.tankutility.com) email address
-* **password** *(Required)*: [https://app.tankutility.com](https://app.tankutility.com) password
-* **devices** *(Required)*: List of devices
-
-Authentication:
-
-Authentication for the Tank Utility API is performed with the same email and password credentials used at
-[https://app.tankutility.com](https://app.tankutility.com).
-
-Devices:
-
-Each item in the list of devices is a 24 character string.  These values can be found by clicking on the **Usage
-Reports** link at the bottom of the graph on the [Tank Utility devices page](https://app.tankutility.com/#/devices).
-The device item value is the last segment of the URL path, e.g., the URL
-[https://app.tankutility.com/#/reports/000000000000000000000000](https://app.tankutility.com/#/reports/000000000000000000000000)
-would indicate `000000000000000000000000` as a device value.