Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions runbooks/availability-failure.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,9 @@

The **Link check** workflow (`.github/workflows/links.yml`) runs its `availability`
job on a 6-hour schedule and on manual dispatch. It requests the live homepage,
`/stories/`, `/docs/`, `/llms.txt`, `/sitemap.xml`, `/robots.txt`, a sample of the shortcut redirects and `/404.html` over HTTPS and fails
unless every one returns HTTP 200. Use this runbook when that job is red and no recent
`/stories/`, `/docs/`, the `/code/`, `/discord/` and `/join/` shortcut redirects,
`/llms.txt`, `/sitemap.xml`, `/robots.txt`, `/.well-known/security.txt`, `/404.html` and
the software-factory project site (/software-factory/) over HTTPS and fails unless every one returns HTTP 200. Use this runbook when that job is red and no recent
deploy explains it; for a bad commit, use the [rollback runbook](release-rollback.md).

## Who is affected
Expand Down Expand Up @@ -33,6 +34,7 @@ probe runs (about 12 hours) should be treated as an outage, not a blip.
| All paths fail, default `*.github.io` host also fails | GitHub Pages incident or failed Pages build | Check `gh api repos/hivecommons/hivecommons.github.io/pages/builds/latest`; wait for GitHub, or push a forward fix if the build error is ours |
| Custom domain fails, default host works | `CNAME` missing or altered, DNS change, or expired/unprovisioned certificate | Confirm `CNAME` reads `hivecommons.dev`; review Settings → Pages for DNS or HTTPS warnings; re-save the custom domain to re-trigger certificate provisioning |
| One or two paths return 404 | Redirect page or top-level page removed or renamed | Fix the `MAP` in `make-redirects.sh` and re-run `./make-redirects.sh`; do not hand-edit generated redirect pages |
| Only the software-factory project site (/software-factory/) fails | That path is served by the sibling `hivecommons/software-factory` Pages repo, not this one | Triage in that repo's Pages settings and latest build; nothing here can fix it |
| A path returns 5xx or times out intermittently | Pages/CDN degradation | Re-run after a few minutes; escalate only if it persists |
| The probe URL list no longer matches the site | A probed page was intentionally removed | Update the list in the `availability` job and keep `scripts/availability-probes.test.mjs` passing; never drop a probe just to turn the job green |

Expand Down
Loading