From 0d28e3a810d532c6caae2900be6c9f697772c811 Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Tue, 1 Mar 2016 07:44:23 +0100
Subject: [PATCH] Add discoverable docs

---
 source/_components/discoverable.markdown | 35 ++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 source/_components/discoverable.markdown

diff --git a/source/_components/discoverable.markdown b/source/_components/discoverable.markdown
new file mode 100644
index 00000000000..19c16ce0ac3
--- /dev/null
+++ b/source/_components/discoverable.markdown
@@ -0,0 +1,35 @@
+---
+layout: page
+title: "Discoverable"
+description: "Instructions how to setup the discoverable component with Home Assistant."
+date: 2016-03-01 07:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+The Home Assistant discovery protocol is a lightweight feature that introduces support for Home Assistant servers to be discoverable. This will allow [Home Assistant instances](https://github.com/balloob/micropython-home-assistant) running with [MicroPython](https://micropython.org/) to get started without any required configuration (Example from the [MicroPython Home Assistant](https://github.com/balloob/micropython-home-assistant) documentation):
+
+```python
+from homeassistant.discovery import get_instance()
+
+hass = get_instance()
+
+for state in hass.states():
+    print(state)
+```
+
+To enable `discovery` in your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yml entry
+discoverable:
+  expose_password: yes
+```
+
+
+Configuration variables:
+
+- **expose_password** (*Optional*): It is up to the user to expose the password in the discovery response (Default: off). If password not exposed, uHA instances will have to provide it (`get_instance('my password')`).
+