-
Notifications
You must be signed in to change notification settings - Fork 6
Document common sandbox startup failures #1
Copy link
Copy link
Open
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationgood first issueGood for newcomersGood for newcomershelp wantedExtra attention is neededExtra attention is neededsandboxSandbox demo and isolated executionSandbox demo and isolated execution
Description
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationgood first issueGood for newcomersGood for newcomershelp wantedExtra attention is neededExtra attention is neededsandboxSandbox demo and isolated executionSandbox demo and isolated execution
1. Document common sandbox startup failures
Labels:
good first issue,documentation,sandboxBody:
New users may hit predictable sandbox setup problems: a busy port, missing editable install, a stale demo database, or confusion about mock mode versus
--real. Add a short troubleshooting section tosandbox/README.mdthat explains these cases and points back to the existing safe defaults.Suggested scope:
./scripts/start_sandbox.sh --port 8877for port conflicts.Acceptance criteria:
sandbox/README.mdhas a new troubleshooting section covering at least three common startup problems.bash -n scripts/start_sandbox.sh.Why it is newcomer-friendly:
This is a documentation-only task with a clear target file, concrete examples, and no need to understand the full collaboration engine internals.
This issue was created from the v5.0 launch backlog in
docs/launch/good-first-issues.md.