Cross-reference commands & processes better

Author: ghostwriternr

src/content/docs/sandbox/api/index.mdx

@@ -17,7 +17,7 @@ import { getSandbox } from '@cloudflare/sandbox';
 const sandbox = getSandbox(env.Sandbox, 'user-123');
 ```
 
-The sandbox ID should be unique per user or session. The same ID will always return the same sandbox instance with persistent state.
+The same sandbox ID will always return the same sandbox instance. You can architect your application to use a single sandbox ID for multiple users, or use unique IDs per user or session. Using unique sandbox IDs per user is recommended if you are providing code generation or execution capabilities directly to your users.
 
 ## API organization
 

src/content/docs/sandbox/guides/background-processes.mdx

@@ -19,10 +19,9 @@ Use `startProcess()` instead of `exec()` when:
 - **Continuous monitoring** - Log watchers, health checkers
 - **Parallel execution** - Multiple services running simultaneously
 
-Use `exec()` for:
-
-- **One-time commands** - Installations, builds, data processing
-- **Quick scripts** - Simple operations that complete and exit
+:::note
+For **one-time commands, builds, or scripts that complete and exit**, use `exec()` instead. See the [Execute commands guide](/sandbox/guides/execute-commands/).
+:::
 
 ## Start a background process
 

src/content/docs/sandbox/guides/execute-commands.mdx

@@ -11,10 +11,15 @@ This guide shows you how to execute commands in the sandbox, handle output, and
 
 ## Choose the right method
 
-The SDK provides two methods for command execution:
+The SDK provides multiple approaches for running commands:
 
-- **`exec()`** - Run a command and wait for complete result. Best for most use cases.
+- **`exec()`** - Run a command and wait for complete result. Best for one-time commands like builds, installations, and scripts.
 - **`execStream()`** - Stream output in real-time. Best for long-running commands where you need immediate feedback.
+- **`startProcess()`** - Start a background process. Best for web servers, databases, and services that need to keep running.
+
+:::note
+For **web servers, databases, or services that need to keep running**, use `startProcess()` instead. See the [Background processes guide](/sandbox/guides/background-processes/).
+:::
 
 ## Execute basic commands
 
@@ -132,6 +137,7 @@ await sandbox.exec('python /workspace/analyze.py data.csv');
 - **Check exit codes** - Always verify `result.success` and `result.exitCode`
 - **Validate inputs** - Escape or validate user input to prevent injection
 - **Use streaming** - For long operations, use `execStream()` for real-time feedback
+- **Use background processes** - For services that need to keep running (web servers, databases), use the [Background processes guide](/sandbox/guides/background-processes/) instead
 - **Handle errors** - Check stderr for error details
 
 ## Troubleshooting