From 049f6af067876196362feb34b07b1120a285f5db Mon Sep 17 00:00:00 2001 From: Pieter Viljoen Date: Sun, 28 Jun 2026 19:38:31 -0700 Subject: [PATCH 1/3] Sync the model-at-a-glance shipped-input list with the glossary Section 0 still listed shipped inputs as source/embedded-data/version-floor/build-config, omitting the package versions added to the glossary and D4.1. Add package versions there too. Co-Authored-By: Claude Opus 4.8 (1M context) --- WORKFLOW.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/WORKFLOW.md b/WORKFLOW.md index 965635b..8371045 100644 --- a/WORKFLOW.md +++ b/WORKFLOW.md @@ -17,7 +17,8 @@ Each guarantee names the **failure it prevents**, so the reason survives a reimp A run targets **one branch, the one it was triggered on** (`github.ref_name`): `main` builds a stable release, `develop` a prerelease. The version is computed once and threaded downstream. A pull request builds and tests but never publishes. The package **publishes itself** when a shipped input changes (the -source, the embedded data, the version floor, or the build configuration), so releases track the code +source, the embedded data, the version floor, the build configuration, or the package versions - so a +dependency bump republishes to keep the package's dependencies current), so releases track the code without a person cutting them. A maintainer dispatches only to force a release. Dependabot and codegen pull requests merge themselves once their checks pass. From cb42b707705f5fdc5e99bb39abf8b4c43232a6b4 Mon Sep 17 00:00:00 2001 From: Pieter Viljoen Date: Sun, 28 Jun 2026 19:41:47 -0700 Subject: [PATCH 2/3] Align section 0 shipped-input wording with the glossary Name the file (Directory.Packages.props) and use "declared dependencies", matching the glossary terminology. Co-Authored-By: Claude Opus 4.8 (1M context) --- WORKFLOW.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/WORKFLOW.md b/WORKFLOW.md index 8371045..7cd2473 100644 --- a/WORKFLOW.md +++ b/WORKFLOW.md @@ -17,8 +17,9 @@ Each guarantee names the **failure it prevents**, so the reason survives a reimp A run targets **one branch, the one it was triggered on** (`github.ref_name`): `main` builds a stable release, `develop` a prerelease. The version is computed once and threaded downstream. A pull request builds and tests but never publishes. The package **publishes itself** when a shipped input changes (the -source, the embedded data, the version floor, the build configuration, or the package versions - so a -dependency bump republishes to keep the package's dependencies current), so releases track the code +source, the embedded data, the version floor, the build configuration, or the package versions +(`Directory.Packages.props`) - so a dependency bump republishes to keep the package's declared dependencies +current), so releases track the code without a person cutting them. A maintainer dispatches only to force a release. Dependabot and codegen pull requests merge themselves once their checks pass. From b6977ca13e8bf6496ab4a059b5ad69a3ddc5d8e7 Mon Sep 17 00:00:00 2001 From: Pieter Viljoen Date: Sun, 28 Jun 2026 19:45:18 -0700 Subject: [PATCH 3/3] Simplify the section 0 shipped-input sentence Use dashes for the list (no nested parentheses) and move the dependency-currency note into its own sentence, so each clause has a single causal link. Co-Authored-By: Claude Opus 4.8 (1M context) --- WORKFLOW.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/WORKFLOW.md b/WORKFLOW.md index 7cd2473..f4f9fac 100644 --- a/WORKFLOW.md +++ b/WORKFLOW.md @@ -16,11 +16,11 @@ Each guarantee names the **failure it prevents**, so the reason survives a reimp A run targets **one branch, the one it was triggered on** (`github.ref_name`): `main` builds a stable release, `develop` a prerelease. The version is computed once and threaded downstream. A pull request -builds and tests but never publishes. The package **publishes itself** when a shipped input changes (the +builds and tests but never publishes. The package **publishes itself** when a shipped input changes - the source, the embedded data, the version floor, the build configuration, or the package versions -(`Directory.Packages.props`) - so a dependency bump republishes to keep the package's declared dependencies -current), so releases track the code -without a person cutting them. A maintainer dispatches only to force a release. Dependabot and codegen +(`Directory.Packages.props`) - so releases track the code without a person cutting them. Listing the package +versions means a dependency bump republishes too, keeping the package's declared dependencies current. A +maintainer dispatches only to force a release. Dependabot and codegen pull requests merge themselves once their checks pass. ### Glossary