Configuration has grown into a domain of its own with no page that describes it #21

New Issue

2026-09-21T07:18:07Z

cgalo5758 commented

2026-09-21 07:18:07 +00:00

Where

docs/environment-reference.md, and the model pages under docs/models/.

What it says

The environment reference lists the keys a deployment sets and what each one does. That was the whole of configuration while configuration was only environment variables. It is no longer: a key can now come from a default, from the environment or from a row an operator wrote, each with its own precedence, its own type and its own rule about when the value takes effect.

What it should say

Configuration needs the same kind of description the other domains have: what a key is, which layers exist and in what order they win, where each layer stores its values, which keys are secret, and when a change takes effect. The reference stays the list of keys; the description of the mechanism is its own page, and it is owed once core keys move onto the same layered seam the integration keys use.

Migrated from status/issues.md at b7a0e15

## Where [`docs/environment-reference.md`](https://git.coopcloud.tech/wiki-cafe/member-console/src/commit/b7a0e15/docs/environment-reference.md), and the model pages under `docs/models/`. ## What it says The environment reference lists the keys a deployment sets and what each one does. That was the whole of configuration while configuration was only environment variables. It is no longer: a key can now come from a default, from the environment or from a row an operator wrote, each with its own precedence, its own type and its own rule about when the value takes effect. ## What it should say Configuration needs the same kind of description the other domains have: what a key is, which layers exist and in what order they win, where each layer stores its values, which keys are secret, and when a change takes effect. The reference stays the list of keys; the description of the mechanism is its own page, and it is owed once core keys move onto the same layered seam the integration keys use. Migrated from status/issues.md at b7a0e15

cgalo5758 added the

kind

docs

area/ops area/meta labels 2026-09-21 07:18:07 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wiki-cafe/member-console#21