docs: add ORA reminder notifications how-to

source/site_ops/how-tos/enable_notifications.rst

@@ -7,7 +7,7 @@ Enable Notifications
 
 :ref:`Notifications <Notifications & Preferences>` keep you informed about activity in your
 courses, alerting you via one or both of in-platform notifications and email notifications.
-They span activities such as Discussions updates, Course updates, and Grading updates.
+They span activities such as Discussions updates, Course updates, Grading updates, and ORA review reminders.
 
 The **notification tray** allows learners to access platform notifications from
 the top-right corner of the Open edX interface. **Notification emails** keep them updated when
@@ -144,6 +144,10 @@ The following cron job sends the weekly digest every **Sunday at 10:00 PM**:
    this can be modified to run at the hours/days of choice.
 
 
+.. seealso::
+
+   :ref:`ORA Reminder Notifications` — configure periodic nudges for learners who have not completed peer or self review steps in ORA assignments.
+
 **Maintenance chart**
 
 +--------------+-------------------------------+----------------+--------------------------------+

source/site_ops/how-tos/ora_reminders.rst

@@ -0,0 +1,78 @@
+.. _ORA Reminder Notifications:
+
+ORA Reminder Notifications
+##########################
+
+.. tags:: site operator, how-to
+
+ORA reminders send periodic nudges to learners who have submitted a response
+but have not yet completed their required **peer** or **self** review steps.
+
+Enabling
+********
+
+Set ``ENABLE_ORA_REMINDERS`` to ``True`` in your Django settings:
+
+.. code-block:: python
+
+    ENABLE_ORA_REMINDERS = True
+
+The notification type ``ora_reminder`` must also be registered in edx-platform's
+``openedx.core.djangoapps.notifications.base_notification`` (already included
+in edx-platform ≥ the version that ships this feature).
+
+Configuration Settings
+**********************
+
+All settings have sensible defaults and only need to be overridden when you
+want non-default behaviour.
+
+.. list-table::
+   :header-rows: 1
+   :widths: 35 10 55
+
+   * - Setting
+     - Default
+     - Description
+   * - ``ORA_REMINDER_INITIAL_DELAY_HOURS``
+     - ``0``
+     - Hours after submission before the **first** reminder is sent. Gives
+       learners time to complete reviews on their own before being nudged.
+   * - ``ORA_REMINDER_INTERVAL_HOURS``
+     - ``48``
+     - Hours between consecutive reminders after the first one.
+   * - ``ORA_REMINDER_MAX_COUNT``
+     - ``3``
+     - Maximum number of reminders sent per learner per ORA submission.
+       Once this limit is reached the reminder row is deactivated.
+   * - ``ORA_REMINDER_SWEEP_INTERVAL_SECONDS``
+     - ``1800``
+     - How often (in seconds) the sweeper re-schedules itself. Each run
+       processes all rows whose ``next_reminder_at`` has passed.
+   * - ``ORA_REMINDER_SWEEP_BATCH_SIZE``
+     - ``1000``
+     - Maximum rows processed per sweep cycle. If more rows are due they
+       will be picked up on the next sweep. Rows are ordered oldest-first so
+       no reminder is permanently skipped. Increase this value for deployments
+       with a large number of concurrent active learners.
+   * - ``ORA_REMINDER_CHECK_AGAIN_HOURS``
+     - ``12``
+     - Hours to wait before re-checking when a peer-step reminder is due
+       but no peer submissions are available for the learner to review yet.
+       Prevents sending useless reminders to very early submitters.
+
+Example override (in your LMS environment settings):
+
+.. code-block:: python
+
+    ORA_REMINDER_INITIAL_DELAY_HOURS = 48   # wait 2 days before first nudge
+    ORA_REMINDER_INTERVAL_HOURS = 72        # then nudge every 3 days
+    ORA_REMINDER_MAX_COUNT = 2              # send at most 2 reminders
+
+**Maintenance chart**
+
++--------------+-------------------------------+----------------+--------------------------------+
+| Review Date  | Working Group Reviewer        |   Release      |Test situation                  |
++--------------+-------------------------------+----------------+--------------------------------+
+|              |                               |                |                                |
++--------------+-------------------------------+----------------+--------------------------------+