From b163306d55f7cb6e535ad465cd1e7d0dab983b85 Mon Sep 17 00:00:00 2001 From: Omry Yadan Date: Tue, 20 Oct 2026 18:47:33 +0800 Subject: [PATCH] Clarify v1 workflow references in maintenance docs The behavior reference and scheduling guide still describe SHA-only callers after the v1 release policy was introduced. Document matching major release tags or full commit SHA pins consistently with the setup guide. Validation: seven integration contract tests passed; all eight public documentation files have existing relative link targets and no AWD mentions or local paths. This is a documentation correction; runtime behavior is unchanged. --- docs/audit-schedules.md | 3 ++- node/maintenance.md | 5 +++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/audit-schedules.md b/docs/audit-schedules.md index 68f072d..20fad60 100644 --- a/docs/audit-schedules.md +++ b/docs/audit-schedules.md @@ -53,7 +53,8 @@ In the [setup guide's caller](node-maintenance.md#3-add-the-caller-workflow), us - upgrades ``` -Keep the remaining caller jobs, permissions, SHA pins, and audit input forwarding: +Keep the remaining caller jobs, permissions, workflow references (`@v1` or matching +full commit SHAs), and audit input forwarding: ```yaml with: diff --git a/node/maintenance.md b/node/maintenance.md index 2978aa6..8abbe87 100644 --- a/node/maintenance.md +++ b/node/maintenance.md @@ -168,5 +168,6 @@ to the built-in token. See [credential setup and PR CI behavior](../docs/node-ma The workflow does not add CI-skip markers. Consumer CI follows its configured triggers and token rules. Neither authentication mode waits for additional PR CI -or merges the PR. Consumers call both shared workflows at the same full commit -SHA; update both pins together using the [update instructions](../docs/node-maintenance.md#update-or-migrate-an-installation). +or merges the PR. Consumers call both shared workflows at the same major release +tag, such as `@v1`, or the same full commit SHA. Change both references together +using the [update instructions](../docs/node-maintenance.md#update-or-migrate-an-installation).