Runbooks

Step-by-step fixes for incidents we’ve actually hit. Each one is written so someone who has never seen the problem can resolve it.

• Images / domain not resolving — site images (or a whole domain) suddenly fail to load. Covers the hellobellocdn.com outage pattern.
• Company card changed — the checklist to run through every vendor so nothing lapses.
• Vercel didn’t deploy on merge — a merge to main didn’t trigger a production deploy.

Writing a new runbook

When you resolve an incident, add a runbook while it’s fresh. Keep the shape consistent:

1. Symptom — what the reporter sees.
2. How to confirm — the exact command(s)/checks that prove the diagnosis.
3. Root cause — what’s actually wrong.
4. Fix — numbered steps.
5. Prevention — what stops it recurring.