diff --git a/docs/policy/documentation.md b/docs/policy/documentation.md index 44c5934..9e981b4 100644 --- a/docs/policy/documentation.md +++ b/docs/policy/documentation.md @@ -1,8 +1,8 @@ # Documentation Policy -**Base Policy Version:** 1.11 +**Base Policy Version:** 1.12 -**Last Updated**: 2026-09-27 +**Last Updated**: 2026-11-09 ## Base Policy Template @@ -94,7 +94,7 @@ secret values. | Integration contracts for external components (if applicable) | `docs/integrations/` | External formats and protocols, upstream and downstream contracts, logical output paths and schemas, media types, and compatibility. | Physical runtime placement and lifecycle, internal transformations, CLI syntax, configuration defaults. | | Inventory of implemented internal packages | `docs/internal/overview.md` | Implemented packages and components, responsibilities, and links to focused internal docs. | Normative architecture, contributor reading policy, external contracts. | | Behavior and architecture of internal packages | Other files under `docs/internal/` | Implementation flow, collaborators, state transitions, package-local guarantees and failures, and relevant tests. | Global architecture invariants, configuration definitions and defaults, external schemas, operator procedures. | -| Architectural decision records | `docs/adr/` | Significant decisions, context, alternatives, rationale, consequences, and supersession history. | Current behavior reference, implementation status, task sequencing. | +| Architectural decision records | `docs/adr/` | Records of significant architectural decisions and supporting rationale. | Ordinary design choices, current behavior reference, implementation status, task sequencing. | | Future work and implementation status | `docs/roadmap/` | Proposed, accepted, deferred, or rejected work; implementation status, sequencing, and task breakdowns. | Implemented behavior reference and architectural decision rationale. | | Release-note history | `docs/releases/` | One checked-in summary per source release under the procedure; the note at its immutable tag is the release record. | Current commands, behavior, contracts, and compatibility definitions. | | Complete copyable artifacts | `examples/` | Maintained configuration, inputs, and other copyable or runnable files. | Field-by-field reference, command reference, prose explanation. | diff --git a/docs/policy/oss.md b/docs/policy/oss.md index 0f23a76..2db8789 100644 --- a/docs/policy/oss.md +++ b/docs/policy/oss.md @@ -1,8 +1,8 @@ # Open Source Licensing And Attribution Policy -**Base Policy Version:** 1.8 +**Base Policy Version:** 1.9 -**Last Updated**: 2026-09-27 +**Last Updated**: 2026-11-09 ## Base Policy Template @@ -81,7 +81,8 @@ individual packages. Use the upstream [application COPYRIGHT example](https://gitea.maximumdirect.net/eric/policy/src/commit/a469273adda336625f96b9d769ea27b33999f146/examples/licensing/application/COPYRIGHT) or [library COPYRIGHT example](https://gitea.maximumdirect.net/eric/policy/src/commit/a469273adda336625f96b9d769ea27b33999f146/examples/licensing/library/COPYRIGHT) -to create the project’s root `COPYRIGHT` file. +to create the project’s root `COPYRIGHT` file. Use the examples exactly as +provided, without modification, unless otherwise instructed. Use verified project names, contribution years, and copyright holders. For another selected license, adapt the grant, SPDX expression, disclaimer, and text references together to reflect the author's selected grant. diff --git a/docs/policy/release.md b/docs/policy/release.md index de83dab..ba034c9 100644 --- a/docs/policy/release.md +++ b/docs/policy/release.md @@ -1,8 +1,8 @@ # Release Policy -**Base Policy Version:** 1.6 +**Base Policy Version:** 1.7 -**Last Updated**: 2026-10-08 +**Last Updated**: 2026-11-09 ## Base Policy Template @@ -84,6 +84,10 @@ For releases at or after `v1.0.0`: minimum as described below; and - a patch release may make backward-compatible fixes. +In this context, "backward-compatible" means only that pre-existing, valid +configurations will continue to work following the relase. Behavior need not +remain strictly identical. + Before `v1.0.0`, a minor release may change a documented public, operational, configuration, data, integration, or compatibility contract when the release note explains the impact and required consumer action. A patch release must