Skip to content

PT-2534: Switch ChatOps docs to irbot /ir slash commands (hold until irbot deploy)#7

Draft
hankwallace wants to merge 1 commit into
masterfrom
irbot-slash-commands
Draft

PT-2534: Switch ChatOps docs to irbot /ir slash commands (hold until irbot deploy)#7
hankwallace wants to merge 1 commit into
masterfrom
irbot-slash-commands

Conversation

@hankwallace
Copy link
Copy Markdown

Hold until the new irbot service is deployed. Opened as a draft on purpose — mark ready and merge once /ir is live in Slack. Merging triggers the auto-deploy workflow, which rebuilds and publishes the site.

Switches the incident-response documentation from the legacy opsbot !ir message commands to the new irbot Slack slash commands.

Commands: !ir …/ir …

Across all docs (call_etiquette, severity_levels, what_is_an_incident, during_an_incident, security_incident_response, chatops, internal_liaison):

Old New
!ir /ir
!ir page /ir page
!ir page <user> /ir page <user>
!ir page responders /ir page responders
!ir responders /ir responders
!ir who <user> /ir who <target>
  • /ir who <target> behavior updated to match irbot: if <target> is a team name it shows that team's on-call; otherwise it's treated as a Slack user search. (Command surface per irbot's README / manifest.yaml.)
  • ChatOps intro reframed: incident-response commands are now Slack slash commands handled by our incident response bot — not !-prefixed messages "watched for" in-channel.

Removed the !status family (deferred)

The status bot is deferred for now, so all !status references are removed rather than left dangling: the ChatOps Status section, the scribe "status stalking" steps, the during-an-incident "status monitoring bot" step, and the orphaned status.png / status_stalk.png screenshots.

Favicon fix

The browser-tab icon was still PagerDuty's (bundled in the theme). Added the Elimu Informatics favicon (reused from engage-web) at theme_overrides/assets/images/favicon.png, which overrides the theme's assets/images/favicon.png via theme.custom_dir.

Notes

  • The ir_*.png ChatOps screenshots are unchanged here — they'll be recaptured against the live irbot UI (separately).
  • mkdocs build --clean passes; built site has 0 !ir and 0 !status references, the favicon is overridden, and the #ir-page anchor (linked from the training course) still resolves.

🤖 Generated with Claude Code

Update docs for the new irbot service (replaces the legacy opsbot !ir
message commands with Slack slash commands):

- !ir ... -> /ir ... across all docs (page, responders, page responders,
  page <user>, bare /ir).
- /ir who <user> -> /ir who <target>: irbot resolves a team name to that
  team's on-call, otherwise treats the target as a user search.
- Reframe the ChatOps page intro: incident-response commands are Slack
  slash commands handled by our incident response bot (no longer '!'-prefixed
  message commands watched for in-channel).
- Remove the !status command family (status bot is deferred): the ChatOps
  Status section, the scribe status-stalking steps, the during-an-incident
  status-monitoring step, and the now-orphaned status screenshots.
- Fix the browser-tab favicon: override the theme's bundled PagerDuty
  favicon with the Elimu Informatics favicon via theme.custom_dir.

Screenshots (ir_*.png) are unchanged here; they'll be recaptured against
the live irbot UI.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@hankwallace hankwallace changed the title Switch ChatOps docs to irbot /ir slash commands (hold until irbot deploy) PT-2534: Switch ChatOps docs to irbot /ir slash commands (hold until irbot deploy) May 30, 2026
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