phase 1 5 docs site

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.ts and docs/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 PathActionNotes
docs/app/app/robots.tsAddDocs robots
docs/app/app/sitemap.tsAddDocs sitemap
docs/app/src/lib/layout.config.tsxModifyExternal landing link
ibexdepo (separate PR)ModifyLanding docs link + sitemap

Testing Requirements

  • test_docs_nav_has_landing_link: Docs header links to ibexharness.com
  • test_landing_nav_has_docs_link: Landing header links to docs.ibexharness.com
  • test_robots_exists: /robots.txt returns 200 on docs
  • test_sitemap_exists: /sitemap.xml returns 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.sh passes against production

Risks

RiskProbabilityImpactMitigation
Landing PR delayed blocks cross-navMediumHighCoordinate ibexdepo PR before merge
Sitemap includes stub noindex pagesLowMediumOnly index pages with real content
GSC verification not doneLowLowManual GSC sitemap submit post-merge
Edit on GitHub

Last updated on

On this page

0%