Incident communication guidelines for status page updates
Last updated
Draft — needs review before this goes on the public docs.
When posting status page updates during an incident:
- First update within 10 minutes of the incident opening, even if it only says "we're investigating elevated error rates on the API"
- Say what customers observe, not what's broken internally ("checks may be delayed" — not "NATS consumer lag")
- Update at least every 30 minutes while the incident is open, even if nothing changed
- The resolution note states impact duration and scope plainly. No "we apologize for any inconvenience this may have caused" filler
- Postmortem link goes on the incident within 5 business days for major incidents