diff --git a/docs/03-development.md b/docs/03-development.md index 46f447b..4a5f785 100644 --- a/docs/03-development.md +++ b/docs/03-development.md @@ -5,9 +5,8 @@ - [Testing guide](testing/README.md) - [Troubleshooting deep dive](troubleshooting/README.md) -This page describes the **canonical contributor workflow** for Mission Control, including local dev loops and CI parity. +How we develop Mission Control locally, with a workflow that stays close to CI. -> Evidence basis: consolidated from repo root `README.md`, `.github/workflows/ci.yml`, `Makefile`, `scripts/with_node.sh`, and `docs/testing/README.md`. ## Prerequisites diff --git a/docs/06-configuration.md b/docs/06-configuration.md index 50d0716..e4998c6 100644 --- a/docs/06-configuration.md +++ b/docs/06-configuration.md @@ -13,8 +13,6 @@ Mission Control is a 3-service stack (`compose.yml`): Postgres (`db`), FastAPI b ### Docker Compose (recommended local/self-host) -Evidence: `compose.yml`, `.env.example`, `backend/.env.example`. - Precedence (highest → lowest): 1) **Explicit runtime environment** passed to Compose @@ -37,8 +35,6 @@ Precedence (highest → lowest): ### Backend env-file loading behavior (non-Compose) -Evidence: `backend/app/core/config.py`. - When running the backend directly (e.g., `uvicorn`), settings load from env vars and from these files: - `backend/.env` (always attempted) - `.env` (repo root; optional) @@ -47,12 +43,10 @@ This is intentional so running from repo root still picks up backend config. ### Frontend env-file behavior (non-Compose) -Evidence: `frontend/.env.example`, `compose.yml`. - - Next.js uses `NEXT_PUBLIC_*` variables for browser-visible configuration. - For local dev you typically create `frontend/.env.local` (Next.js convention) or `frontend/.env` (if you want Compose to read it). -## Env var reference (first pass) +## Environment variables This table is based on `backend/app/core/config.py`, `.env.example`, `backend/.env.example`, `frontend/.env.example`, and `compose.yml`.