From 352c6cb15a691a14223ce64d50123ff12d00c0ba Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Thu, 29 Sep 2016 10:55:31 +0200
Subject: [PATCH] Add initial docs for weather component

---
 source/_components/demo.markdown              |  1 +
 source/_components/weather.markdown           | 15 ++++++++
 .../weather.openweathermap.markdown           | 38 +++++++++++++++++++
 3 files changed, 54 insertions(+)
 create mode 100644 source/_components/weather.markdown
 create mode 100644 source/_components/weather.openweathermap.markdown

diff --git a/source/_components/demo.markdown b/source/_components/demo.markdown
index 3ed516f9147..8d2698f4442 100644
--- a/source/_components/demo.markdown
+++ b/source/_components/demo.markdown
@@ -27,6 +27,7 @@ Available demo platforms:
 - [Notification](/components/notify/) (`notify`)
 - [Sensor](/components/sensor/) (`sensor`)
 - [Switch](/components/switch/) (`switch`)
+- [Weather](/components/weather/) (`weather`)
 
 To integrate a demo platform in Home Assistant, add the following section to your `configuration.yaml` file:
 
diff --git a/source/_components/weather.markdown b/source/_components/weather.markdown
new file mode 100644
index 00000000000..784c917048f
--- /dev/null
+++ b/source/_components/weather.markdown
@@ -0,0 +1,15 @@
+---
+layout: page
+title: "Weather"
+description: "Instructions how to setup your Weather platforms with Home Assistant."
+date: 2016-09-28 14:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+Weather platforms are gathering meteorological information from web services and displays the conditions and other details about the weather at the given location. 
+
+Home Assistant currently supports a free web services and such which requires a registration. Please check the sidebar for a full list of supported sensor platforms.
+
diff --git a/source/_components/weather.openweathermap.markdown b/source/_components/weather.openweathermap.markdown
new file mode 100644
index 00000000000..9a870b61341
--- /dev/null
+++ b/source/_components/weather.openweathermap.markdown
@@ -0,0 +1,38 @@
+---
+layout: page
+title: "OpenWeatherMap"
+description: "Instructions how to integrate OpenWeatherMap within Home Assistant."
+date: 2016-09-29 09:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: openweathermap.png
+ha_category: Weather
+ha_release: "0.30"
+---
+
+
+The `openweathermap` weather platform uses [OpenWeatherMap](http://openweathermap.org/) as an source for current meteorological data for your location.
+
+You need an API key which is free but requires a [registration](http://home.openweathermap.org/users/sign_up).
+
+To add OpenWeatherMap to your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+weather:
+  - platform: openweathermap
+    api_key: YOUR_API_KEY
+    latitude: 46.1234
+    longitude: 7.1234
+```
+
+Configuration variables:
+
+- **api_key** (*Required*): Your API key for http://openweathermap.org/.
+- **latitude** (*Optional*): Latitude of the location to display the weather. Defaults to the latitude in your your `configuration.yaml` file. 
+- **longitude** (*Optional*): Longitude of the location to display the weather. Defaults to the longitude in your `configuration.yaml` file.
+
+Details about the API are available in the [OpenWeatherMap documentation](http://openweathermap.org/api).
+