Skip to content

docs(getting-started): fix the zero-to-first-workflow path#23

Merged
enixCode merged 1 commit into
mainfrom
docs/onboarding-fixes
Jun 4, 2026
Merged

docs(getting-started): fix the zero-to-first-workflow path#23
enixCode merged 1 commit into
mainfrom
docs/onboarding-fixes

Conversation

@enixCode
Copy link
Copy Markdown
Owner

@enixCode enixCode commented Jun 4, 2026

Fix getting-started inaccuracies blocking a zero-to-first-workflow run: Node >=18 -> >=20; install both packages and explain all-in-one (auto-spawn) vs explicit runner; replace the fictional light doctor output with the real output from src/cli/doctor.ts (both modes); drop the unconditional dashboard claim (ui/out is not built by default) and add the build steps; add the missing light link --from/--to[--when] step. Docs-only, each claim verified against doctor.ts / serve.ts / link.ts. build with cc

The getting-started page had several inaccuracies that would block a new user:

- Node.js requirement said >= 18; the package requires >= 20.
- Only installed light-process, never the execution server. Install both and
  explain all-in-one (auto-spawn) vs explicit-runner mode.
- The `light doctor` sample output was fictional (showed Docker checks the
  command never runs). Replaced with the real output from src/cli/doctor.ts
  for both the all-in-one and explicit-runner paths.
- Claimed a web dashboard at localhost:3000; the UI (ui/out) is not built by
  default. Added the caveat + build steps.
- Showed how to add a second node but never how to wire it. Added a `light link`
  step with --from/--to and a --when condition example.

build with cc
@enixCode enixCode merged commit aae14aa into main Jun 4, 2026
5 checks passed
@enixCode enixCode deleted the docs/onboarding-fixes branch June 4, 2026 10:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant