fitzee opened a new pull request, #42383: URL: https://github.com/apache/superset/pull/42383
## What & why Adds a short, outcome-led docs front door — **[Raising Your First AI Teammate](apps/agor-docs/content/guide/first-teammate.mdx)** — and brings the onboarding docs in line with the redesigned 5-step wizard now on `main`. Along the way it unbreaks the Agor-managed docs dev environment, which was failing to build for every fresh branch. The framing (chosen after reading the team's canonical Messaging & Positioning doc): a new user shouldn't try to learn all of Agor. The simplest path to value is to raise **one named AI teammate**, give it a real job, and let it guide the rest. BYOLLM, governance, and the "meet the team where they work" story are introduced as things the teammate helps configure — not prerequisites. ## Changes **New page — `guide/first-teammate.mdx`** - Placed between **Overview** and **Getting Started** in the sidebar; cross-linked from the guide overview and the Getting Started intro. - ~800 words: *Don't learn Agor, meet it* · *Bring your own model* · *The takeoff sequence* (6 steps) · *Give it exactly the trust it has earned* (governance) · *Where this can go* · *Your next step*. - A compact `ScreenshotGallery` (thumbnails + lightbox) frames the onboarding arc as outcomes: tell it how you work → connect your own model → give it a name → meet your teammate. `heroImage` set for the social card. **Getting Started rewritten to the shipped wizard** - Replaced the stale *Clone → Board → Branch → API Keys → Launch* copy with the real flow (**You → AI → Workspace → Tools → You're ready**), verified against `OnboardingWizard.tsx`: persona cards, model connection with on-the-spot verification, teammate naming + board creation, persona-tailored MCP suggestions, teammate seeding on completion. - Fresh 2× screenshots; **auth code pixelated** in the connect-AI shot; connect-AI capture taken on the Claude (Recommended) tab. Removed the four superseded `onboarding-*.png` files. - Updated the Teammates guide's wizard description and fixed a dead `#meet-your-first-ai-teammate` anchor in Extended Installation. **Docs dev-environment fix (`apps/agor-docs/Dockerfile`, `docker-compose.yml`)** - pnpm 11 hard-fails on unapproved dependency build scripts (esbuild, sharp) — approve builds for the dev-only image. - Lockfile-less install floated `nextra` to a broken `zod` 4.4.x (500s on every page); pin `zod@^4` to 4.1.12 via an image-side workspace override, mirroring the root lockfile. - Run `next` directly instead of via `pnpm exec` (its deps-status check aborted with no TTY over the bind mount). ## Validation - `pnpm i` — lockfile unchanged. - `pnpm check` — passes except a **pre-existing** `agor-ui#typecheck` failure (shiki 3.23.0 vs 3.15.0 via `@streamdown/code`); this branch touches neither `agor-ui` nor the lockfile, so it reproduces identically on `main`. - Docs-scoped: `tsc --noEmit` clean · `pnpm build` green (49 pages) · social-metadata validation passes. - `OnboardingWizard` tests: **27/27 passing** — confirms the documented flow matches the shipped component. - Reviewed both pages live in the Agor-managed docs environment (desktop + mobile). ## Follow-ups (out of scope) - The wizard's MCP cards link to `agor.live/docs/mcp/*` paths that don't exist on the docs site — likely 404s worth a separate fix. - A competing session created a near-duplicate page (`guide/first-ai-teammate.mdx`) and KB doc; pick a winner before both merge. 🤖 Generated with [Claude Code](https://claude.com/claude-code) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
