Browse Source

timegen docs

boyska 4 years ago
parent
commit
0813f9015c
2 changed files with 32 additions and 0 deletions
  1. 1 0
      doc/source/index.rst
  2. 31 0
      doc/source/timegenerators.rst

+ 1 - 0
doc/source/index.rst

@@ -13,6 +13,7 @@ Contents:
 
    about
    install
+   timegenerators
    audiogenerators
    eventfilters
    audiogenerators-write

+ 31 - 0
doc/source/timegenerators.rst

@@ -0,0 +1,31 @@
+Timegenerators
+===============
+
+A "timegenerator" is something that describe _when_ you want to do something.
+
+There are 3 kinds of timegenerators in larigira:
+
+
+single
+------------
+
+With single, you just set a single time the event should happen.
+
+frequency
+--------------
+
+Sometimes you have something happening very regularly. For example you might want a jingle every 30minutes, or
+a specific show every friday at 8PM.
+
+cron
+----------
+
+Sometimes your specification is very complex.
+
+For example, you might want a specific message to be sent at 10:00, 13:00, 15:00 and 18:00, but only during
+working days. That would be hard to do with a single `frequency` event, so you could use a cron
+
+    0 10,13,15,18 * * 1-5
+
+I know, that's very difficult, but is still a possibility you have. If you want to learn how to write crons,
+check `this helpful site <https://crontab.guru>`_.