Make documentation standalone and generalize examples

Makefile

@@ -1,15 +1,13 @@
 # ─── Fluksio app Makefile ───
 # Convenience targets for development, testing, linting, and deployment.
-# The workspace root delegates to these (see ../Makefile).
 
 .PHONY: init env-check dev-utils dev dev-local dev-lan rebuild-frontend up down update install dev-backend dev-frontend \
         generate-client sync-example test test-backend test-checks test-stack test-frontend test-webkit soak \
         bench-startup bench-engine lint lint-backend lint-frontend format-frontend umami build docs docs-serve clean help
 
 COMPOSE_ROOT := $(CURDIR)
-# Explicit project name keeps this stack isolated from the sibling website
-# stack (otherwise both default to "docker", the directory their compose
-# files live in).
+# An explicit project name avoids collisions with other Compose stacks
+# whose configuration also lives in a directory named "docker".
 COMPOSE_PROJECT := fluksio-app
 # Compose interpolation needs the project-local .env before reading compose.yml.
 COMPOSE := docker compose -p $(COMPOSE_PROJECT) --env-file $(COMPOSE_ROOT)/.env
@@ -77,7 +75,7 @@ dev-utils:  ## Start only the utility containers (proxy, mailcatcher)
 dev:  ## Start the full dev stack (includes a local Traefik proxy)
 	$(COMPOSE_DEV) up --build
 
-dev-local:  ## Start the local stack at http://app.localhost (also run by the root `make dev`)
+dev-local:  ## Start the local stack at http://app.localhost
 	DOMAIN=$${DOMAIN:-localhost} ENVIRONMENT=$${ENVIRONMENT:-local} \
 	  $(COMPOSE_LOCAL) up --build -d --remove-orphans proxy backend docs mailcatcher
 
@@ -122,7 +120,7 @@ umami:  ## Provision + start the optional Umami site-analytics service (idempote
 	# start when its session-signing secret is unset or still the placeholder.
 	@secret=$$(grep -E '^UMAMI_APP_SECRET=' $(COMPOSE_ROOT)/.env 2>/dev/null | head -1 | cut -d= -f2-); \
 	if [ -z "$$secret" ] || [ "$$secret" = "changethis" ]; then \
-		echo "ERROR: UMAMI_APP_SECRET is empty or 'changethis' in .env — run the workspace root's scripts/setup.sh (or set it: openssl rand -hex 32) before 'make umami'." >&2; \
+		echo "ERROR: UMAMI_APP_SECRET is empty or 'changethis' in .env — set it in .env with 'openssl rand -hex 32' before 'make umami'." >&2; \
 		exit 1; \
 	fi
 	# --no-recreate: reuse an already-running db instead of recreating it under
@@ -135,7 +133,7 @@ umami:  ## Provision + start the optional Umami site-analytics service (idempote
 	pw=$$(grep -E '^UMAMI_DB_PASSWORD=' $(COMPOSE_ROOT)/.env 2>/dev/null | head -1 | cut -d= -f2-); \
 	db=$$(grep -E '^UMAMI_DB=' $(COMPOSE_ROOT)/.env 2>/dev/null | head -1 | cut -d= -f2-); db=$${db:-umami}; \
 	if [ -z "$$pw" ] || [ "$$pw" = "changethis" ]; then \
-		echo "ERROR: UMAMI_DB_PASSWORD is empty or 'changethis' in .env — run the workspace root's scripts/setup.sh before 'make umami'." >&2; \
+		echo "ERROR: UMAMI_DB_PASSWORD is empty or 'changethis' in .env — set it in .env with 'openssl rand -hex 32' before 'make umami'." >&2; \
 		exit 1; \
 	fi; \
 	$(COMPOSE_PROD) exec -T db psql -v ON_ERROR_STOP=1 -U "$$pguser" -d postgres \