eric/ConfigKit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Clarify v0.9.0 import and collection migration guidance

Browse Source
This commit is contained in:
Eric Rakestraw
2026-10-24 14:48:21 +00:00
parent b3ec860fac
commit 7ff204bf3d
1 changed files with 4 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
docs/releases/v0.9.0.md
View File

@@ -53,7 +53,8 @@ migration guidance below before upgrading.
This pre-v1 minor release intentionally changes the v0.8.0 contracts: This pre-v1 minor release intentionally changes the v0.8.0 contracts:
1. **Migrate import requiredness.** The YAML `optional` field is removed and is 1. **Migrate import requiredness.** The YAML `optional` field is removed and is
rejected. Replace `optional: true` with `required: false` or omit it; replace rejected. Replace `optional: true` with `required: false`; omission is equivalent
when the application does not default imports to required. Replace
`optional: false` with `required: true`. Imports that previously relied on `optional: false` with `required: true`. Imports that previously relied on
implicit requiredness now need `required: true`, or an application implicit requiredness now need `required: true`, or an application
`ImportDefaults.Required` default set to true. Review discovery filters: `ImportDefaults.Required` default set to true. Review discovery filters:
@@ -78,6 +79,8 @@ This pre-v1 minor release intentionally changes the v0.8.0 contracts:
defaults to upsert across layers and inheritance when no explicit mode defaults to upsert across layers and inheritance when no explicit mode
applies, rather than unconditional whole-sequence replacement. Declare applies, rather than unconditional whole-sequence replacement. Declare
`mode: replace` at the relevant destination where replacement is intended. `mode: replace` at the relevant destination where replacement is intended.
With append or upsert, `[]` contributes no records and does not clear the
collection; null is invalid. Use `mode: replace` with `[]` to clear it.
An explicit mode persists at its destination until changed; a parent's mode An explicit mode persists at its destination until changed; a parent's mode
does not transfer to a different inheriting destination. Unidentified does not transfer to a different inheriting destination. Unidentified
sequences retain strict peer conflicts and whole-value precedence sequences retain strict peer conflicts and whole-value precedence