Skip to content

Commit add1266

Browse files
denelonCopilot
andcommitted
Add deprecation note: no breaking changes in 1.X, repo schema policy drives adoption
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent bae1807 commit add1266

1 file changed

Lines changed: 2 additions & 0 deletions

File tree

doc/specs/#3483 - UserMessages.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -443,6 +443,8 @@ Messages in locale manifests override those in the defaultLocale manifest on a p
443443
444444
The timeline for each phase is driven by client adoption telemetry, not fixed dates. Phase 4 (removal) is explicitly deferred to a future specification.
445445
446+
> **Important:** There is no intent to make breaking changes in WinGet 1.X. The WinGet CLI will continue to function normally with manifests that use `InstallationNotes`, regardless of deprecation phase. The practical driver for deprecation is the **WinGet Community Repository** (winget-pkgs) schema version policy. The community repository requires new manifest submissions to use schema version **n** or **n-1** (the current or immediately prior version). As the repository moves forward to schema versions where `UserMessages` is the expected field, publishers and manifest authors will be required to adopt the new field and stop using `InstallationNotes` as a condition of submitting to the community repository — not because the client rejects it, but because the repository's validation pipeline enforces the current schema versions.
447+
446448
## Future Considerations
447449
448450
The `UserMessages` object is designed to be extended. Potential future additions include:

0 commit comments

Comments
 (0)