From e2a6ff4c9314148db1602a51b6357815146a7fc9 Mon Sep 17 00:00:00 2001
From: runningman84 <runningman84@users.noreply.github.com>
Date: Sat, 9 Sep 2017 09:39:40 +0200
Subject: [PATCH] Added docs for DWD WarnApp Sensor (#3062)

* Added docs for dwdwarnapp

* Updated documentation

As suggested by Landrash
---
 source/_components/sensor.dwdwarnapp.markdown | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 source/_components/sensor.dwdwarnapp.markdown

diff --git a/source/_components/sensor.dwdwarnapp.markdown b/source/_components/sensor.dwdwarnapp.markdown
new file mode 100644
index 00000000000..618794ea4cb
--- /dev/null
+++ b/source/_components/sensor.dwdwarnapp.markdown
@@ -0,0 +1,43 @@
+---
+layout: page
+title: "DWD Warn Weather"
+description: "Instructions on how to integrate Deutsche Wetter Dienst weather warnings into Home Assistant."
+date: 2017-07-26 22:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+#logo: dwdwarnapp.png
+ha_category: Weather
+ha_release: 0.51
+ha_iot_class: "Cloud Polling"
+---
+
+The `dwdwarnapp` sensor platform uses the [Deutsche Wetter Dienst (DWD)](http://www.dwd.de) as a source for current and advance warnings.
+
+- A name is optional but if multiple regions are used a name will be required.
+- The sensor checks for new data every 15 minutes.
+
+To add the DWD WarnApp sensor to your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+sensor:
+  - platform: dwdwarnapp
+    region_name: Hansestadt Hamburg
+```
+
+To get the region name:
+- Find your region here: `https://www.dwd.de/DE/wetter/warnungen_landkreise/warnWetter_node.html?ort=Hamburg`
+- Verify if you find any warning for your region here: `https://www.dwd.de/DWD/warnungen/warnapp_landkreise/json/warnings.json?jsonp=loadWarnings`
+
+The warning level is between 0 (no danger) and 4 (warnings of extreme weather):
+- Warnungen vor extremem Unwetter (Stufe 4)
+- Unwetterwarnungen (Stufe 3)
+- Warnungen vor markantem Wetter (Stufe 2)
+- Wetterwarnungen (Stufe 1)
+
+Configuration variables:
+
+- **region_name** (*Optional*): The region name string as identified from the DWD website.  If not given, defaults to Hansestadt Hamburg.
+- **name** (*Optional*): The name you would like to give to the warnapp sensor.