Skip to content

Commit 05de7ee

Browse files
Marius StorhaugMarius Storhaug
authored andcommitted
Clarify superseded actions during release replay
1 parent 1247c91 commit 05de7ee

2 files changed

Lines changed: 3 additions & 0 deletions

File tree

‎docs/content/guides/formatting-release-note-prs.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,8 @@ services, infrastructure modules, and published guidance.
2424
Each release records its incremental change from a declared release/source baseline. Consumers compose the applicable
2525
records after their current baseline through their selected target. The newest note does not replace intervening
2626
instructions, and an individual note does not need a migration manual from every historical version.
27+
When later instructions supersede earlier edits, explain which actions remain for the target and preserve any
28+
explicitly required intermediate installation or run.
2729

2830
| Surface | Content it owns |
2931
| --- | --- |

‎docs/content/guides/versioning-and-releases.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ Identify the consumer's current release/source baseline and selected target, the
2020
release record after that baseline through the target in order. Compose the stated prerequisites, adoption or
2121
migration actions, and verification for the consumer's starting state. Reading the intervening records does not
2222
require installing or running every intermediate version; do so only when a record explicitly requires it.
23+
Apply later supersession instructions while preserving any required intermediate operations.
2324

2425
The notes provide the complete change, rationale, impact, and action or explicit no-action result. Pull requests and
2526
commit diffs provide optional depth. Missing required instructions are an evidence gap to resolve with the producer.

0 commit comments

Comments
 (0)