From 29465251ab3e41098770ebdcf9a996604930cdbe Mon Sep 17 00:00:00 2001 From: Malachi Willey Date: Wed, 8 Oct 2025 10:26:59 -0700 Subject: [PATCH 1/2] feat(digests): Add more explanatory test about the min/max delivery interval --- docs/product/alerts/create-alerts/issue-alert-config.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/product/alerts/create-alerts/issue-alert-config.mdx b/docs/product/alerts/create-alerts/issue-alert-config.mdx index 13e18b16318df..d095b86591d1e 100644 --- a/docs/product/alerts/create-alerts/issue-alert-config.mdx +++ b/docs/product/alerts/create-alerts/issue-alert-config.mdx @@ -143,4 +143,6 @@ In **[Project] > Settings > Alerts**, you can configure alert email subject temp The digests feature only works for issue alert emails (not notifications sent through integrations), and unlike the [action interval](#action-interval-rate-limit), limits the total number of alert emails sent for the project. This project-level setting allows you to control the minimum and maximum delivery intervals for alerts. +The minimum interval determines the earliest time that another digest will be sent (when compared to the previously sent email). Subsequent alerts will delay the next digest email, up until the maximum interval. If there hasn’t been a recent digest, the first alert is delivered immediately. + ![A sliding adjustment scale for the frequency of alert emails.](./img/alert-digest.png) From fda2fa9e4d63991f7d7137c9a97f6eba1dc2eba5 Mon Sep 17 00:00:00 2001 From: Malachi Willey Date: Tue, 14 Oct 2025 15:59:21 -0700 Subject: [PATCH 2/2] Edits Co-authored-by: Alex Krawiec --- docs/product/alerts/create-alerts/issue-alert-config.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/product/alerts/create-alerts/issue-alert-config.mdx b/docs/product/alerts/create-alerts/issue-alert-config.mdx index d095b86591d1e..00ccd89b46526 100644 --- a/docs/product/alerts/create-alerts/issue-alert-config.mdx +++ b/docs/product/alerts/create-alerts/issue-alert-config.mdx @@ -143,6 +143,6 @@ In **[Project] > Settings > Alerts**, you can configure alert email subject temp The digests feature only works for issue alert emails (not notifications sent through integrations), and unlike the [action interval](#action-interval-rate-limit), limits the total number of alert emails sent for the project. This project-level setting allows you to control the minimum and maximum delivery intervals for alerts. -The minimum interval determines the earliest time that another digest will be sent (when compared to the previously sent email). Subsequent alerts will delay the next digest email, up until the maximum interval. If there hasn’t been a recent digest, the first alert is delivered immediately. +The minimum interval sets how soon another digest can be sent after the previous one. Each new alert resets the timer, delaying the next digest until the maximum interval is reached. If there hasn’t been a recent digest, the first alert is delivered immediately. ![A sliding adjustment scale for the frequency of alert emails.](./img/alert-digest.png)