Document source-root configuration controls

This commit is contained in:
2026-11-02 00:45:36 +00:00
parent e5475ea7f8
commit 68ec552b52
8 changed files with 73 additions and 34 deletions

View File

@@ -7,6 +7,16 @@ Your application still owns CLI parsing, resource reads, remote acquisition, and
runtime initialization.
Import `"go.maximumdirect.net/configkit"`; the package name is `configkit`.
Document controls now use root `config` in every source. Rename genuine old
`configkit` or `_configkit` control blocks and update stored declaration paths
from `/configkit/...` to `/config/...`. Old blocks become ordinary data and a
permissive schema can accept them without executing imports. Move, rename, or
separately mount application fields previously authored as source-root `config`.
Nested and assembled root `config` values remain ordinary application data; the
[mounted-root example](../../examples/consumers/config_controls_test.go) shows
the boundary. See the [configuration contract](../config.md#declaration-and-selection-rules)
for the complete rules.
Start with one file, then choose the tasks your application needs:
| Task | Start here |