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

Record accepted import architecture decisions

Browse Source
This commit is contained in:
Eric Rakestraw
2026-10-19 14:24:19 +00:00
parent c26b34147b
commit 94381a67fd
3 changed files with 155 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
docs/roadmap/imports.md
View File

@@ -1,13 +1,20 @@
# Import Ergonomics And Permissive Defaults
Status: working draft / brainstorming notes. This document captures a proposed
direction for discussion, not an implemented contract or an implementation plan.
Status: accepted design; implementation pending. This document captures planned
behavior and requirements. Implementation sequencing remains to be prepared.
The selected direction separates directory searches, filename matching,
recursion, and absence handling. Optional-by-default imports are the intended
direction. The consumer-directed and Ansible-aligned decisions below are settled;
API spelling and implementation details remain for implementation planning.
All new syntax below is illustrative and unimplemented.
The durable architectural decisions are recorded in
[ADR 0015: Share Dependency-Ready Ordering Across Imports and Inheritance](../adr/0015-shared-dependency-ready-ordering.md)
and
[ADR 0016: Separate Import Selection, Traversal, and Presence Requirements](../adr/0016-independent-import-controls.md).
This roadmap owns implementation status and the detailed requirements for
carrying out those accepted decisions.
## Guiding Philosophy
ConfigKit should provide predictable configuration mechanisms and avoid imposing