From 5eba15c0e4f7a267a9afd22afdcc8c75df3b7763 Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Sun, 28 Jan 2018 23:07:24 +0100
Subject: [PATCH] Add example

---
 source/_components/timer.markdown | 36 ++++++++++++++++++++++++++++---
 1 file changed, 33 insertions(+), 3 deletions(-)

diff --git a/source/_components/timer.markdown b/source/_components/timer.markdown
index 7cb9984ee82..61ff400aea0 100644
--- a/source/_components/timer.markdown
+++ b/source/_components/timer.markdown
@@ -92,17 +92,19 @@ Select <img src='/images/screenshots/developer-tool-services-icon.png' alt='serv
 }
 ```
 
-### {% linkable_title Configuration example %}
+## {% linkable_title Examples %}
+
+Set a timer called `test` to a duration of 30 seconds. 
 
 ```yaml
 # Example configuration.yaml entry
-
-# Set a timer called test to a duration of 30 seconds: 
 timer:
   test:
     duration: '00:00:30'
 ```
 
+### {% linkable_title Control a timer from the frontend %}
+
 ```yaml
 # Example automations.yaml entry
 - action:
@@ -131,3 +133,31 @@ timer:
       entity_id: timer.test
 ```
 
+### {% linkable_title Control a timer from the frontend %}
+
+With the [`script`](/components/script/) component you would be able to control a timer (see above for a `timer` configuration sample) manually.
+
+```yaml
+script:
+  start_timer:
+    alias: Start timer
+    sequence:
+      - service: timer.start
+        entity_id: timer.test
+  pause_timer:
+    alias: Pause timer
+    sequence:
+      - service: timer.pause
+        entity_id: timer.test
+  cancel_timer:
+    alias: Cancel timer
+    sequence:
+      - service: timer.cancel
+        entity_id: timer.test
+  finish_timer:
+    alias: Finish timer
+    sequence:
+      - service: timer.finish
+        entity_id: timer.test
+```
+