Skip to content

Conversation

Dalje-et
Copy link
Contributor

What does this PR do? What is the motivation?

Merge instructions

Merge readiness:

  • Ready for merge

For Datadog employees:

Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

[6/5/2025] Merge queue has been disabled on the documentation repo. If you have write access to the repo, the PR has been reviewed by a Documentation team member, and all of the required checks have passed, you can use the Squash and Merge button to merge the PR. If you don't have write access, or you need help, reach out in the #documentation channel in Slack.

Additional notes

@Dalje-et Dalje-et requested a review from a team as a code owner September 23, 2025 10:31
{{< img src="service_management/oncall/escalation_policy_2_steps_v2.png" alt="An escalation policy configured to notify the scheduled on-call user and escalate to Jane Doe if the page is not acknowledged after 5 minutes." style="width:100%;" >}}
1. Set how many times to repeat the steps if no one acknowledges the page.
1. Select whether Datadog should automatically update the page status to **Resolved** after executing all rules and repeats.
1. Select whether Datadog should automatically update the page status to **Resolved** after executing all rules and repeats. *(This only applies if no one acknowledges; once acknowledged, escalation stops and the page won’t auto-resolve.)*
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Select whether Datadog should automatically update the page status to **Resolved** after executing all rules and repeats. *(This only applies if no one acknowledges; once acknowledged, escalation stops and the page won’t auto-resolve.)*
1. Select whether Datadog should automatically update the page status to **Resolved** after executing all rules and repeats. *(This only applies if no one acknowledges; once acknowledged, escalation stops and the page won’t auto-escalate nor auto-resolve.)*

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Italics feels unnecessary, since the parentheses already set off the statement and call attention to it. Also "or" is more conversational than "nor":

Suggested change
1. Select whether Datadog should automatically update the page status to **Resolved** after executing all rules and repeats. *(This only applies if no one acknowledges; once acknowledged, escalation stops and the page wont auto-resolve.)*
1. Select whether Datadog should automatically update the page status to **Resolved** after executing all rules and repeats. (This only applies if no one acknowledges; once acknowledged, escalation stops and the page won't auto-escalate or auto-resolve.)

Copy link
Contributor

Preview links (active after the build_preview check completes)

Modified Files

Copy link
Contributor

@joepeeples joepeeples left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved with a minor edit suggestion, thanks!

{{< img src="service_management/oncall/escalation_policy_2_steps_v2.png" alt="An escalation policy configured to notify the scheduled on-call user and escalate to Jane Doe if the page is not acknowledged after 5 minutes." style="width:100%;" >}}
1. Set how many times to repeat the steps if no one acknowledges the page.
1. Select whether Datadog should automatically update the page status to **Resolved** after executing all rules and repeats.
1. Select whether Datadog should automatically update the page status to **Resolved** after executing all rules and repeats. *(This only applies if no one acknowledges; once acknowledged, escalation stops and the page won’t auto-resolve.)*
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Italics feels unnecessary, since the parentheses already set off the statement and call attention to it. Also "or" is more conversational than "nor":

Suggested change
1. Select whether Datadog should automatically update the page status to **Resolved** after executing all rules and repeats. *(This only applies if no one acknowledges; once acknowledged, escalation stops and the page wont auto-resolve.)*
1. Select whether Datadog should automatically update the page status to **Resolved** after executing all rules and repeats. (This only applies if no one acknowledges; once acknowledged, escalation stops and the page won't auto-escalate or auto-resolve.)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants