From 0213c09a62113eba5c66cb973cd418bba5e02cd3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Jan 2024 17:33:37 +0100
Subject: [PATCH] [Scheduler] Document hashed cron expressions

---
 scheduler.rst | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 6f2c25f03a4..bf0644f1911 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -157,15 +157,28 @@ class, as shown in the following examples.
 Cron Expression Triggers
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-It uses the same syntax as the `cron command-line utility`_::
+Before using cron triggers, you have to install the following dependency:
+
+.. code-block:: terminal
+
+    composer require dragonmantank/cron-expression
+
+Then, define the trigger date/time using the same syntax as the
+`cron command-line utility`_::
 
     RecurringMessage::cron('* * * * *', new Message());
 
-Before using it, you have to install the following dependency:
+You can also used some special values that represent common cron expressions:
 
-.. code-block:: terminal
+* ``#yearly``, ``#annually`` - Run once a year, midnight, Jan. 1 - ``0 0 1 1 *``
+* ``#monthly`` - Run once a month, midnight, first of month - ``0 0 1 * *``
+* ``#weekly`` - Run once a week, midnight on Sun - ``0 0 * * 0``
+* ``#daily``, ``#midnight`` - Run once a day, midnight - ``0 0 * * *``
+* ``#hourly`` - Run once an hour, first minute - ``0 * * * *``
 
-    composer require dragonmantank/cron-expression
+For example::
+
+    RecurringMessage::cron('#daily', new Message());
 
 .. tip::