From b198c72a5e0022cd1040d3ed2313d358a840cac9 Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen <paulus@paulusschoutsen.nl>
Date: Mon, 15 May 2017 22:52:50 -0700
Subject: [PATCH] Add info about automation editor

---
 source/_docs/automation/editor.markdown      | 58 ++++++++++++++++++++
 source/_includes/asides/docs_navigation.html |  1 +
 2 files changed, 59 insertions(+)
 create mode 100644 source/_docs/automation/editor.markdown

diff --git a/source/_docs/automation/editor.markdown b/source/_docs/automation/editor.markdown
new file mode 100644
index 00000000000..c494e70d6d0
--- /dev/null
+++ b/source/_docs/automation/editor.markdown
@@ -0,0 +1,58 @@
+---
+layout: page
+title: "Automation Editor"
+description: "Instructions on how to use the new automation editor."
+date: 2016-04-24 08:30 +0100
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+In Home Assistant 0.45 we have introduced the first version of our automation editor. The editor is still in a very early stage and rough around the edges. For now we are only supporting Chrome but better browser support is planned for the future.
+
+If you just created a new config with Home Assistant then you're all set! Go to the UI and enjoy.
+
+## {% linkable_title Updating your config to use the editor %}
+
+The automation editor reads and writes to the file `automations.yaml` in your configuration folder. Make sure that you have set up the automation component to read from it:
+
+```yaml
+# Configuration.yaml example
+automation: !include automations.yaml
+```
+
+If you still want to use your old automation section, add a label to the old entry:
+
+```yaml
+automation old:
+- trigger:
+    platform: …
+```
+
+## {% linkable_title Migrating your automations to automations.yaml %}
+
+If you want to migrate your old automations to use the editor, you'll have to copy them to `automations.yaml`. Make sure that `automations.yaml` remains a list! For each automation that you copy over you'll have to add an id. This can be any string as long as it's unique.
+
+```yaml
+# Example automations.yaml entry
+- id: my_unique_id  # <-- Required for editor to work.
+  alias: Hello world
+  trigger:
+  - entity_id: sun.sun
+    from: below_horizon
+    platform: state
+    to: above_horizon
+  condition:
+  - above: 17
+    below: 25
+    condition: numeric_state
+    entity_id: sensor.temperature
+    value_template: '{{ float(state.state) + 2 }}'
+  action:
+  - service: light.turn_on
+```
+
+<p class='note'>
+Any comments in the YAML file will be lost when you update an automation via the editor.
+</p>
diff --git a/source/_includes/asides/docs_navigation.html b/source/_includes/asides/docs_navigation.html
index 7e027961802..2c7957a23ff 100644
--- a/source/_includes/asides/docs_navigation.html
+++ b/source/_includes/asides/docs_navigation.html
@@ -55,6 +55,7 @@
         {% active_link /docs/automation/ Automation %}
         <ul>
           <li>{% active_link /docs/automation/examples/ Examples %}</li>
+          <li>{% active_link /docs/automation/editor/ Editor %}</li>
           <li>{% active_link /docs/automation/trigger/ Triggers %}</li>
           <li>{% active_link /docs/automation/condition/ Conditions %}</li>
           <li>{% active_link /docs/automation/action/ Actions %}</li>