From 7b09ea1a46c7e8fef77f7976c593d15f2c1a2e19 Mon Sep 17 00:00:00 2001 From: Eric Rakestraw Date: Sun, 27 Sep 2026 19:18:36 +0000 Subject: [PATCH] Clarify document creation and upstream reading guidance --- docs/development.md | 2 +- docs/policy/documentation.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/development.md b/docs/development.md index dfd3cf6..d52adbc 100644 --- a/docs/development.md +++ b/docs/development.md @@ -16,7 +16,7 @@ application interfaces or infrastructure. | Policy | Read before… | | --- | --- | -| [Policy set provenance](policy/meta.md) | Adopting policies, checking upstream revisions, or updating the adopted policy set. | +| [Adoption and update guide](adoption.md) | Adopting policies, checking upstream revisions, or updating the adopted policy set. | | [Agents](policy/agents.md) | Recommending, planning, or implementing repository changes. | | [Architecture](policy/architecture.md) | Planning or changing application code or its structure. | | [Testing](policy/testing.md) | Selecting validation for code changes, or adding, changing, removing, or evaluating tests. | diff --git a/docs/policy/documentation.md b/docs/policy/documentation.md index ac99ea5..2edb93a 100644 --- a/docs/policy/documentation.md +++ b/docs/policy/documentation.md @@ -1,6 +1,6 @@ # Documentation Policy -**Base Policy Version:** 1.8 +**Base Policy Version:** 1.9 **Last Updated**: 2026-09-27 @@ -9,7 +9,7 @@ This document is the base template for the canonical documentation policy. Repositories that implement this policy should: 1. Review the list of documents under the `Canonical Ownership` heading, remove any entries that do not currently apply and are not expected to apply to the current project, and add any additional entries that may be required by the current project; -2. Ensure that each referenced document is present on the filesystem, even if the initial content is simply `TODO`; +2. Create documents for applicable responsibilities when substantive content is available; 3. Update the `Last Updated` field to the current date; and 4. Remove this heading (`Base Policy Template`) and the associated text.