Skip to content

Apply review feedback to the 4 R's of incident communication rule - #13103

Open
tomek-i wants to merge 1 commit into
mainfrom
rule/incident-communication-feedback
Open

Apply review feedback to the 4 R's of incident communication rule#13103
tomek-i wants to merge 1 commit into
mainfrom
rule/incident-communication-feedback

Conversation

@tomek-i

@tomek-i tomek-i commented Jul 30, 2026

Copy link
Copy Markdown
Member

Follow-up to #13076, applying the review feedback that came in after the merge.

Changes

Feedback Change
The Incidents prefix is noise and doesn't group with any other rule Title is now Do you know the 4 R's of incident communication?
The first 6 paragraphs are dense Intro cut to 3 short paragraphs, with the "pear-shaped" hook moved below <endIntro />
A list violates Do you avoid full stops in lists, captions, and immediately after a URL? Multi-sentence bullets rephrased to single sentences with no trailing full stops
The emoji paragraphs should be Heading 4s All 9 promoted from bold text to ####
"Final Word" doesn't add much Section removed
"Cheatsheet" doesn't need an emoji Renamed to Summary, emoji dropped, <hr /> added above

The full stop fix hit 3 lists, not 1: the "if you can't help" bullets, the 3 A's (item 1 was the only one ending in a stop), and the Resolve list (item 3 was multi-sentence without one).

The title change also updates the link text in unplanned-outage-process. The uri is unchanged, so no redirect is needed.

Still outstanding

The rule has no images or video. A pair of redacted Teams screenshots (the vague back and forth vs. what good looks like) would be the strongest addition.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Neq6zBKEwCyXY1HHacrPfd

- Drop the "Incidents - " title prefix, it doesn't group with any other rule
- Condense the intro from 6 dense paragraphs to 3
- Fix full stops in lists, per /avoid-full-stops
- Promote the emoji paragraphs to Heading 4s
- Remove the "Final word" section
- Rename "Cheatsheet" to "Summary", drop the emoji, add an <hr /> above

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Neq6zBKEwCyXY1HHacrPfd
@github-actions

Copy link
Copy Markdown
Contributor

🔍 Preview PR Changes

View updated pages in edit mode:

Branch: rule/incident-communication-feedback

@github-actions github-actions Bot added Age: 🥚 - New About 2 hours old Age: 🐣 - Young About 4 hours old Age: 🐥 - Adolescent About 8 hours old Age: 🐤 - Mature About 16 hours old Age: 🐓 - Old About 32 hours old Age: 🍗 - Ancient About 64 hours old 🔥 Merge Debt This PR contains merge debt, see https://www.ssw.com.au/rules/merge-debt/ and removed Age: 🥚 - New About 2 hours old Age: 🐣 - Young About 4 hours old Age: 🐥 - Adolescent About 8 hours old Age: 🐤 - Mature About 16 hours old Age: 🐓 - Old About 32 hours old labels Jul 30, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Howzit @tomek-i,

This PR has been here a while.

Did you know you should avoid merge debt?

  1. Please action (e.g. get a review) and merge or close

Thanks!

@github-actions github-actions Bot added Age: 🦖 - Extinct About 128 hours old and removed Age: 🍗 - Ancient About 64 hours old labels Aug 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Age: 🦖 - Extinct About 128 hours old 🔥 Merge Debt This PR contains merge debt, see https://www.ssw.com.au/rules/merge-debt/

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants