docs: restructure navigation around products and per-product onboarding

[Seagull-Y]

Summary

Restructures the documentation site to align with how users actually consume it: pick a product → follow setup → run a demo → dive into the full product page. Removes the parallel SDK / Examples / Guides hierarchy and merges those into the relevant product pages.

Before

Top nav: Products | Get Started | SDK | Examples | Guides | Releases | i2rt.com

docs/
├── getting-started/   installation, hardware-setup, quick-start  (3 monolithic pages)
├── products/          (product pages with limited content)
├── sdk/               yam-arm, flow-base, grippers
├── guides/            gravity-compensation
├── examples/          bimanual, record-replay, motor-control, mujoco, viser, gello
├── releases/          v1.0, v1.1, v1.1.1
└── support/           troubleshooting

After

Top nav: Get Started | Products | i2rt.com

docs/
├── getting-started/
│   ├── sw-setup                    one-time CAN + Python env
│   ├── hardware/
│   │   └── {yam, yam-cell, yam-box, flow-base, linear-bot, motors}
│   └── demos/
│       └── {yam, yam-cell, yam-box, flow-base, linear-bot, motors}
└── products/
    ├── yam.md          ← merged: SDK API + grippers + gravity-comp guide
    │                              + MuJoCo + Viser + record-replay
    ├── yam-cell.md     ← merged: bimanual teleop + minimum_gello
    ├── flow-base.md    ← merged: full FlowBaseClient SDK API
    ├── motors.md       ← merged: single-motor PD control example
    └── yam-arm, yam-leader, yam-box, linear-bot, motor-gf*

What changed

New files (13)

• docs/getting-started/sw-setup.md
• docs/getting-started/hardware/{yam, yam-cell, yam-box, flow-base, linear-bot, motors}.md
• docs/getting-started/demos/{yam, yam-cell, yam-box, flow-base, linear-bot, motors}.md

Expanded product pages

• products/yam.md — now ~800 lines: specs + photos + full API reference + gravity-comp guide + MuJoCo & Viser control + record-replay
• products/yam-cell.md — added bimanual teleop walkthrough + minimum_gello reference
• products/flow-base.md — added full FlowBaseClient SDK API
• products/motors.md — added single-motor PD example + config tools

Deleted (no longer needed)

• docs/sdk/ → merged into product pages
• docs/examples/ → merged into product pages
• docs/guides/ → merged into product pages
• docs/releases/ → use GitHub Releases
• docs/support/troubleshooting.md → not in new nav
• docs/getting-started/{installation, hardware-setup, quick-start}.md → replaced by sw-setup + per-product pages

Config

• docs/.vitepress/config.mjs — nav reduced to 3 items; sidebar collapsed to two top-level groups (Get Started, Products)
• docs/index.md — CTAs point to /getting-started/sw-setup and /getting-started/demos/yam

Internal links

All /sdk/, /examples/, /guides/, /releases/, /support/, /getting-started/{installation, hardware-setup, quick-start} references rewritten to new paths or in-page anchors.

Verification

• npm run docs:build clean (no warnings, no broken links)
• All in-page anchor targets verified (#api-reference, #gravity-friction-compensation, #bimanual-teleoperation, etc.) — 1 match each in deployed HTML
• All 13 new pages render at expected routes
• Local preview verified at localhost:4173/JH_i2rt/

Test plan

• Click through Get Started → SW Setup → Hardware → Demo flow for each product
• Open each product page and verify TOC navigation (right sidebar) works for the long ones (yam in particular)
• Confirm top nav and side nav match the new structure
• Check that no 404s appear when clicking around

🤖 Generated with Claude Code

[Seagull-Y]

Closing — the docs content has been migrated to the private repo i2rt-robotics/i2rt-docs (with all the changes in this PR plus more). The docs/ folder will be removed from this public repo in a follow-up PR.