From 8fbec579ea9835ada2cffffe25d43885e74ce4b7 Mon Sep 17 00:00:00 2001
From: Abhimanyu Saharan <desk.abhimanyu@gmail.com>
Date: Wed, 11 Feb 2026 09:46:17 +0000
Subject: [PATCH] docs: tone pass (remove boilerplate evidence notes)

---
 docs/03-development.md   | 3 +--
 docs/06-configuration.md | 8 +-------
 2 files changed, 2 insertions(+), 9 deletions(-)

diff --git a/docs/03-development.md b/docs/03-development.md
index 46f447b3..4a5f785f 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 50d0716c..e4998c65 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`.