Final launch acceptance
Verification RequiredFinal launch acceptance report.
This report records the docs launch-foundation decision: the source work is ready for release-candidate review, and production cutover stays gated on the exact merge commit, pipeline evidence, environment checks, reviewer signoffs, and launch watch.
Decision Snapshot
- Story points complete
- 817
- Remaining planned work
- 0
- Source P0/P1 blockers
- 0
- Review fields due
- 6
- Watch window
- 30 days
Build Identity
| Field | Current record | Required release-time review basis |
|---|---|---|
| Reviewed source base | main at a508f45, after review record merged. | Replace with the PR merge commit or deployed source commit before production go/no-go. |
| review record candidate | codex/review record-final-launch-acceptance, with the candidate commit recorded in PR handoff and CI output. | Use the branch tip or merge commit that contains this report and the generated route assets. |
| Pipeline identity | Not available from source alone. | Attach Azure pipeline run ID, deployment stage, artifact identity, and validation result. |
| Deployed version | Not available until deployment. | Capture /version.txt, deployed hostname, response headers, and route manifest checks. |
Validation Commands
| Gate | Command | Launch rule |
|---|---|---|
| Metadata and source posture | npm run validate:docs-metadata; npm run validate:verification-dispositions; npm run validate:claim-lint; npm run validate:release-docs | Hold for metadata drift, risky claims, stale review labels, or release-doc regressions. |
| Examples and reference integrity | npm run validate:examples; npm run validate:snippets; npm run validate:tutorial-smoke; npm run validate:reference-schema; npm run validate:compatibility-matrix | Hold if runnable examples, tutorial claims, reference records, or compatibility rows would mislead a reader. |
| Routing, privacy, assets, and links | npm run validate:pr-routing; npm run validate:analytics-privacy; npm run validate:external-assets; npm run validate:links; npm run validate:links:strict | Hold if review routing, privacy posture, asset fallbacks, or approved links regress. |
| Public route manifests | npm run validate:seo-crawl; npm run validate:llms | Hold if sitemap, robots, canonical metadata, LLM exports, or route coverage drift. |
| Production build | npm run build | Hold if Gatsby cannot build the static site. |
| Required browser suite | DOCS_SITE_BASE_URL=http://localhost:8002 dotnet test Automation/Stornamics.DocsWebsite.Automation.sln | Hold if representative or full-route browser coverage fails on the release candidate. |
Review Signoffs
| Reviewer | Owns | Required decision |
|---|---|---|
| Release owner | Promotion order, exact build identity, go/hold/rollback decision, and launch watch start. | Accept with environment evidence. |
| Docs lead | Route inventory, reader task flow, voice, labels, and launch-language boundaries. | Accept with no P0/P1 content blocker. |
| Docs platform reviewer | Gatsby build, generated assets, deployment host checks, cache, and rollback readiness. | Accept with build and environment evidence. |
| Docs QA reviewer | Validation commands, browser result, route smoke, console posture, and responsive coverage. | Accept with passing test output. |
| Product SMEs | ObjectDB, Message Broker, Concordia, and LogDB behavior, limits, evidence, and maturity posture. | Accept completed product-lane dispositions. |
| Support, security, legal, and operations | Public intake, evidence redaction, sensitive claims, incident hooks, and launch watch ownership. | Accept or record a launch hold. |
Accepted Risks
| Risk | Severity | Owner | Acceptance posture |
|---|---|---|---|
| Final deploy identity and environment samples are only available after the release candidate is deployed. | P1 gate | release owner | Attach merge commit, pipeline run, /version.txt, DNS/TLS/cache samples, and route checks before production go/no-go. |
| NuGet vulnerability metadata can warn when package feeds are unreachable from a local run. | P2 | security reviewer | Accept only when CI or a reviewer workstation authenticates feeds or records that no private package is expected. |
| npm advisory data can change after review record remediation. | P2 | docs platform and security | Rerun npm audit before production promotion; hold if a launch-significant advisory returns. |
| Inline page rating controls and remote analytics remain disabled. | P2 | support and privacy | Accept because feedback, support, issue templates, and browser-local page health provide launch-safe signals. |
| Optional visual polish can follow launch. | P3 | docs lead | Accept as normal backlog polish when text, labels, fallbacks, and navigation remain clear. |
Launch Watch
| Window | Owner | Required check |
|---|---|---|
| Pre-launch rehearsal | release owner and docs platform reviewer | Confirm merge commit, pipeline run, approved internal pre-production evidence, rollback mode, route manifests, and watch roster. |
| Launch day | release owner, docs QA reviewer, and support reviewer | Check home, search, status, support, legal, feedback, operations, product hubs, sitemap, LLM exports, and 404 behavior. |
| First 48 hours | docs triage lead | Review failed searches, broken journeys, support reports, page-health signals, client errors, and unresolved P0/P1 decisions. |
| First business week | support reviewer and docs platform reviewer | Assign follow-ups, merge duplicates, and update release notes or changelog entries when docs behavior changes. |
| Days 8 through 30 | docs lead | Move non-blocking P2/P3 work into the normal backlog and keep unresolved P0/P1 items on release watch until closed. |
Go/No-Go Decision
| Decision layer | Current decision | Stop condition |
|---|---|---|
| Source readiness | Go for release-candidate review. Planned docs launch-foundation work is complete and source gates are defined. | Hold if this PR fails build, validation, generated-route coverage, or reviewer source review. |
| Release candidate | Conditional go after merge. | Hold if CI or approved internal pre-production evidence differs from the accepted source posture. |
| Production cutover | Conditional go only after release owner attaches environment evidence and signoffs. | Hold or roll back for any P0/P1 route, build, browser, legal/privacy, security, support, or deploy issue. |
| Post-launch operation | Go with the launch-watch plan and 30-day triage cadence. | Escalate if launch signals show repeated broken journeys, misleading product claims, or unsafe evidence. |