From aceab5246c1cbe1b13e02f298128b272a061b91b Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen <paulus@paulusschoutsen.nl>
Date: Mon, 15 May 2017 22:57:25 -0700
Subject: [PATCH] Update automation editor help texts

---
 panels/automation/ha-automation-picker.html | 13 ++++++++++---
 preact-src/automation.js                    | 15 +++++++++++----
 2 files changed, 21 insertions(+), 7 deletions(-)

diff --git a/panels/automation/ha-automation-picker.html b/panels/automation/ha-automation-picker.html
index ef52eed2fd..23e8d6755f 100644
--- a/panels/automation/ha-automation-picker.html
+++ b/panels/automation/ha-automation-picker.html
@@ -44,6 +44,10 @@
         bottom: 24px;
         right: 24px;
       }
+
+      a {
+        color: var(--primary-color);
+      }
     </style>
 
     <app-header-layout has-scrolling-region>
@@ -62,11 +66,14 @@
         </paper-card>
 
         <paper-card heading='Pick automation to edit'>
-          <template is='dom-if' if='[[!automations.length]]'>
             <div class='card-content'>
-              We couldn't find any editable automations.
+              The automation editor allows you to create and edit automations.
+              Please read <a href='https://home-assistant.io/docs/automation/editor/' target='_blank'>the instructions</a>
+              to make sure that you have configured Home Assistant correctly.
+              <template is='dom-if' if='[[!automations.length]]'>
+                <p>We couldn't find any editable automations.</p>
+              </template>
             </div>
-          </template>
           <template is='dom-repeat' items='[[automations]]' as='automation'>
             <paper-item>
               <paper-item-body two-line on-tap='automationTapped'>
diff --git a/preact-src/automation.js b/preact-src/automation.js
index 64748314ef..58c3f64290 100644
--- a/preact-src/automation.js
+++ b/preact-src/automation.js
@@ -58,8 +58,10 @@ export default class Automation extends Component {
         <ha-config-section is-wide={isWide}>
           <span slot='header'>Triggers</span>
           <span slot='introduction'>
-            Like a journey, every automation starts with a single step.
-            In this case it's what should trigger the automation.
+            Triggers are what starts the processing of an automation rule.
+            It is possible to specify multiple triggers for the same rule.
+            Once a trigger starts, Home Assistant will validate the conditions,
+            if any, and call the action.
             <p><a href="https://home-assistant.io/docs/automation/trigger/" target="_blank">
               Learn more about triggers.
             </a></p>
@@ -71,7 +73,12 @@ export default class Automation extends Component {
           <ha-config-section is-wide={isWide}>
             <span slot='header'>Conditions</span>
             <span slot='introduction'>
-              Conditions can be used to prevent an automation from executing.
+              Conditions are an optional part of an automation rule and can be used to prevent
+              an action from happening when triggered. Conditions look very similar to triggers
+              but are very different. A trigger will look at events happening in the system
+              while a condition only looks at how the system looks right now. A trigger can
+              observe that a switch is being turned on. A condition can only see if a switch
+              is currently on or off.
               <p><a href="https://home-assistant.io/docs/scripts/conditions/" target="_blank">
                 Learn more about conditions.
               </a></p>
@@ -87,7 +94,7 @@ export default class Automation extends Component {
         <ha-config-section is-wide={isWide}>
           <span slot='header'>Action</span>
           <span slot='introduction'>
-            The action part defines what the automation should do.
+            The actions are what Home Assistant will do when the automation is triggered.
             <p><a href="https://home-assistant.io/docs/scripts/" target="_blank">
               Learn more about actions.
             </a></p>