phase 1 5 docs site

Launch gate (D.6) needs a single script operators run against preview or production to confirm key pages, 404, and OG metadata — not ad-hoc curl commands. Encodes acceptance criteria from D.2.8 and D.2.4 into repeatable smoke via web-smoke.sh.

Milestone D.5.2 — verify_phase15.sh

Status: Complete
Goal: D.5
Phase: 1.5 — Docs Site
Wave: 11
Estimated effort: 2 hours
ADR required: None

Spec detail: MASTER_BRIEF.md Part D (D.5.2).


Why This Milestone Exists

Launch gate (D.6) needs a single script operators run against preview or production to confirm key pages, 404, and OG metadata — not ad-hoc curl commands.

Encodes acceptance criteria from D.2.8 and D.2.4 into repeatable smoke (wraps .github/scripts/web-smoke.sh).

Blocks Phase 2.1.1 until verify_phase15.sh passes against production.


Non-Goals

  • Load testing docs site
  • Verifying Go service health endpoints
  • Replacing full E2E Playwright suite

Branch

feat/d5-2-verify-script

PR Title

chore(docs): verify_phase15.sh smoke script (D.5.2)


Prerequisites


Deliverables

  • infra/scripts/verify_phase15.sh per MASTER_BRIEF §D.5.2 (adapted for unified apex domain)
  • Wraps .github/scripts/web-smoke.sh plus key pages, 404, OG PNG checks
  • IBEX_SITE_URL env override (fallback: IBEX_DOCS_URL, default production)

See MASTER_BRIEF Part D (D.5.2) for full acceptance detail.


Files Affected

File PathActionNotes
infra/scripts/verify_phase15.shAddPhase 1.5 smoke script

Testing Requirements

  • test_script_key_pages_200: All listed paths return 200
  • test_script_404_status: Unknown path returns 404 not 200
  • test_script_og_image: OG route returns image/png
  • test_script_web_smoke: Delegates to .github/scripts/web-smoke.sh (search index, redirect, landing marker)

Acceptance Criteria

  • Script exits 0 against local dev server (IBEX_SITE_URL=http://localhost:3000)
  • Script exits 0 against production (https://ibexharness.com)

Risks

RiskProbabilityImpactMitigation
curl differences on Windows Git BashMediumMediumDocument WSL/macOS/Linux; CI runs on ubuntu
Script drift when routes renameMediumMediumCentralize path list; update with D.3.1 changes
Edit on GitHub

Last updated on

On this page

0%