Landing and docs are separate deploys but one product. Users must navigate ibexharness.com ↔ docs.ibexharness.com without dead ends. `robots.ts` and `sitemap.ts` on both sites enable GSC indexing after launch.
Milestone D.6.3 — Cross-site nav + sitemaps
Status: Planned
Goal: D.6
Phase: 1.5 — Docs Site
Wave: 12
Estimated effort: 1 hour
ADR required: None
Spec detail: MASTER_BRIEF.md Part D (D.6.3).
Why This Milestone Exists
Landing and docs are separate deploys but one product. Users must navigate ibexharness.com ↔ docs.ibexharness.com without dead ends.
robots.ts and sitemap.ts on both sites enable GSC indexing after launch.
Final launch milestone before Phase 2.1.1 unblocks.
Non-Goals
- Unified monorepo for landing + docs
- Shared auth between sites
- Blog or changelog on landing
Branch
feat/d6-3-launch
PR Title
feat(docs): cross-site nav and sitemaps (D.6.3)
Prerequisites
Deliverables
- Docs nav external link to
https://ibexharness.com - Landing nav external link to
https://docs.ibexharness.com docs/app/app/robots.tsanddocs/app/app/sitemap.ts- Landing site robots/sitemap updated in ibexdepo PR
See MASTER_BRIEF Part D (D.6.3) for full acceptance detail.
Files Affected
| File Path | Action | Notes |
|---|---|---|
docs/app/app/robots.ts | Add | Docs robots |
docs/app/app/sitemap.ts | Add | Docs sitemap |
docs/app/src/lib/layout.config.tsx | Modify | External landing link |
ibexdepo (separate PR) | Modify | Landing docs link + sitemap |
Testing Requirements
test_docs_nav_has_landing_link: Docs header links to ibexharness.comtest_landing_nav_has_docs_link: Landing header links to docs.ibexharness.comtest_robots_exists:/robots.txtreturns 200 on docstest_sitemap_exists:/sitemap.xmlreturns 200 on docs
Acceptance Criteria
- Docs nav contains ibexharness.com link
- Landing nav contains docs.ibexharness.com link
- Both sites ship robots.ts and sitemap.ts
-
verify_phase15.shpasses against production
Risks
| Risk | Probability | Impact | Mitigation |
|---|---|---|---|
| Landing PR delayed blocks cross-nav | Medium | High | Coordinate ibexdepo PR before merge |
| Sitemap includes stub noindex pages | Low | Medium | Only index pages with real content |
| GSC verification not done | Low | Low | Manual GSC sitemap submit post-merge |
Last updated on