Skip to content

[DOCS-13258] Add documentation for responding to Pages#34458

Draft
domalessi wants to merge 1 commit intomasterfrom
domalessi/docs-13258-add-page-response-workflow
Draft

[DOCS-13258] Add documentation for responding to Pages#34458
domalessi wants to merge 1 commit intomasterfrom
domalessi/docs-13258-add-page-response-workflow

Conversation

@domalessi
Copy link
Contributor

What does this PR do? What is the motivation?

Fixes DOCS-13258

This PR addresses user feedback reporting that the On-Call documentation explains how to set up escalation policies but doesn't explain how responders actually interact with and manage Pages.

Changes made:

  • Created a new page: Responding to Pages
    • How to acknowledge a Page (UI and through notification channels)
    • How to resolve a Page (manually and automatically)
    • How to reroute a Page to another responder
    • Explanation of Page statuses (Triggered, Acknowledged, Resolved)
    • Best practices for page management
  • Updated On-Call index page to include link to new page
  • Added "Further reading" section to escalation policies page with cross-reference

User feedback:

"there is no information on how to use pages- like acknowledging, escalating, resolving etc. while i understand these are basic steps, as a software provider, you are supposed to provide these details."

This documentation gap has now been filled with comprehensive instructions for responders.

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

The new page covers the complete responder workflow that was previously undocumented in the On-Call docs.

🤖 Generated with Claude Code

Added a new page explaining how responders interact with Pages:
- How to acknowledge a Page
- How to resolve a Page
- How to reroute a Page
- Page statuses and workflow
- Best practices for page management

This addresses user feedback that the docs explained how to set up
escalation policies but not how to actually use/respond to Pages.

Also updated:
- Added link to new page in On-Call index
- Added "Further reading" section to escalation policies page

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
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.

1 participant