docs: rewrite onboarding for single-paste cold start#37
Open
abdout wants to merge 1 commit into
Open
Conversation
Lead with the canonical irm /install / curl /install.sh one-liners that next.config.ts:16 already wires up. The page previously sent new hires to databayt/codebase/.../install.ps1 — a URL that 404s, since scripts moved to databayt/kun. It also forced a Cowork-first flow that excludes Team/Enterprise plans and hides bootstrap.ps1's 16-step automated flow. Rewrite covers: - Single-paste flow for Windows + macOS/Linux (no more Windows-only) - "Before you start" prerequisites — accounts a new hire needs first - Roles (engineer / business / content / ops) with their bundles - The 16-step table — what bootstrap actually does - OAuth batch UX — the beep + 3 sign-ins at step 12 - Flags (-Role, -Track, -DryRun, -SkipOAuth, -SkipWebStorm, -SkipCowork) - Cowork-driven path kept as optional for Pro/Max users - Troubleshooting table — doctor exit codes, gh auth retry, etc. - /doctor and /maintain added to daily entry points Also fixes claude-code.mdx — 4 stale install URLs swapped to databayt/kun, "Config Sources" dual-source claim corrected. Refs #28 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This was referenced May 18, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Rewrites
content/docs/onboarding.mdxso a fresh hire on Windows, macOS, or Linux can paste one line, watch numbered output, and end with a greendoctor. Also fixes 4 stale URLs incontent/docs/claude-code.mdx.Why
The current
/docs/onboardingpage actively misleads:irm https://raw.githubusercontent.com/databayt/codebase/main/.claude/scripts/install.ps1 | iex— URL 404s (scripts moved todatabayt/kun)bootstrap.sh,install.sh,maintain.sh,doctor.shthat ship in this PR chainkun.databayt.org/installredirect already wired innext.config.ts:16bootstrap.ps1entirely (a 360-line 16-step installer with logging, OAuth batching, GitHub tracking issue, and dry-run mode)engineer | business | content | ops)/doctorand/maintain(shipped in commiteb38508)%USERPROFILE%\projects\databayt\vs the actual~/codebase+~/oss/*)What's new in the rewrite
bootstrap.ps1realitybootstrapruns, what it does, skip flags-Role,-Track,-DryRun,-SkipOAuth,-SkipWebStorm,-SkipCoworkc "/doctor"andc "/maintain install"databayt/kunclaude-code.mdx fix
4 stale
databayt/codebase/main/.claude/scripts/...URLs swapped todatabayt/kun/.... "Config Sources" section's dual-source claim corrected —databayt/kunis now the single source of truth.Dependencies
Stacks on
feat/linux-systemd(PR #36) since the new doc describes features only present in that branch (bootstrap.sh, Linux systemd,/install.shredirect, etc.). Final merge order:After the chain merges, rebase onto main becomes a docs-only diff.
Test plan
pnpm build— MDX compiles cleanlypnpm dev—/en/docs/onboardingrenders without layout breakshttps://kun.databayt.org/install(after merge) — confirms the doc's leading one-liner resolvesgrep -r "databayt/codebase/main/.claude/scripts" content/— zero hitsScreenshots
(none — doc-only change, render locally to spot-check)
Refs #28
🤖 Generated with Claude Code