Goal
Improve the browser-only onboarding path by documenting what a first-time Codespaces user should expect.
Suggested scope
- Update
docs/CODESPACES.md or START_HERE.md.
- Add a short note about dev container startup taking a few minutes.
- Point users to
./scripts/codespaces-smoke.sh and build/install/kaios-cli/bin/kaios tour.
- Include the smallest useful troubleshooting note if the first command is run before the build finishes.
Verification
For a docs-only PR, run:
If you can use Codespaces, also paste whether ./scripts/codespaces-smoke.sh passed.
Notes
Keep this practical and short. The goal is to reduce first-run confusion, not add a full Codespaces tutorial.
Goal
Improve the browser-only onboarding path by documenting what a first-time Codespaces user should expect.
Suggested scope
docs/CODESPACES.mdorSTART_HERE.md../scripts/codespaces-smoke.shandbuild/install/kaios-cli/bin/kaios tour.Verification
For a docs-only PR, run:
If you can use Codespaces, also paste whether
./scripts/codespaces-smoke.shpassed.Notes
Keep this practical and short. The goal is to reduce first-run confusion, not add a full Codespaces tutorial.