docs: simplify quickstart (#1805)

Author: tyler-dane

docs/development/local-development.md

@@ -2,6 +2,8 @@
 
 Compass has multiple workable development modes. Pick the lightest mode that supports the feature you are changing.
 
+For first-time setup, see [Development Quickstart](./quickstart.md).
+
 ## Frontend-Only Mode
 
 Command:
@@ -19,7 +21,7 @@ Use this for:
 
 You do not need the backend for basic frontend rendering.
 
-## Backend Mode
+## Backend
 
 Command:
 

docs/development/quickstart.md

@@ -4,40 +4,22 @@
 
 ```bash
 git clone git@github.com:SwitchbackTech/compass.git
-
 cd compass
-
 bun install
-
-## Setup config values
-
-```bash
-cp compass.example.yaml compass.yaml
 ```
 
-Replace the placeholder values in `compass.yaml`
-
-## Run
-
-Run the web app in one terminal:
+## Run the web app
 
 ```bash
 bun run dev:web
-# Frontend on <http://localhost:9080>
 ```
 
-Run the backend in another terminal:
-
-```bash
-bun run dev:backend  
-# Backend on <http://localhost:3000>
-```
+The frontend runs at <http://localhost:9080>.
 
-## Testing
+## Backend and config
 
-After making your changes, you can run our test suite locally before opening a PR.
+Most frontend work does not need backend services. For backend, auth, MongoDB,
+Google sync, SSE, or CLI work, see [Local Development](./local-development.md).
 
-```bash
-bun run test:core && bun run test:web && bun run test:backend
-bun run test:e2e
-```
+For test commands and expectations, see the
+[Testing Playbook](./testing-playbook.md).

docs/self-hosting/server-guide.md

@@ -149,7 +149,7 @@ curl -fsSL https://raw.githubusercontent.com/SwitchbackTech/compass/main/self-ho
 
 If you'd rather do everything yourself, check-out our [manual install guide](https://raw.githubusercontent.com/SwitchbackTech/compass/main/self-host/install-manual.sh), which has bash commands you can individually copy-paste. This'll give you full visibility and control, but will take longer.
 
-## 3. Configure reverse proxy with Caddy
+## Configure reverse proxy with Caddy
 
 Now that we have Docker, Caddy, and Compass install, we can wire up the proxy to ensure requests flow through your system smoothly.