You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Update attribution language: manifest author, not package publisher
Manifests in the WinGet community repository are frequently authored
by community contributors rather than the software publisher. The
attribution language throughout the spec now reflects this distinction.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copy file name to clipboardExpand all lines: doc/specs/#3483 - UserMessages.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -107,7 +107,7 @@ Pre-action messages are displayed **before** the operation begins and represent
107
107
**Interactive mode (default):**
108
108
109
109
```
110
-
The following information has been provided by the package publisher:
110
+
The following information has been provided by the manifest author:
111
111
112
112
This package requires 2 GB of disk space and will modify your PATH.
113
113
@@ -121,15 +121,15 @@ The user is prompted to confirm. Entering `N` cancels the operation. Entering `Y
121
121
The pre-action message is displayed (rendered to the output stream) but no prompt is shown and the operation proceeds automatically. This ensures automation pipelines see the message in logs without being blocked.
122
122
123
123
```
124
-
The following information has been provided by the package publisher:
124
+
The following information has been provided by the manifest author:
125
125
126
126
This package requires 2 GB of disk space and will modify your PATH.
> **Design rationale:** Pre-action messages are informational, not contractual agreements. Unlike license terms (which require explicit acceptance via `--accept-package-agreements`), user messages are publisher-authored guidance. The `--disable-interactivity` flag is the appropriate suppressor because it already governs all interactive prompts in WinGet. A new flag is not warranted.
132
+
> **Design rationale:** Pre-action messages are informational, not contractual agreements. Unlike license terms (which require explicit acceptance via `--accept-package-agreements`), user messages are manifest-author-provided guidance. The `--disable-interactivity` flag is the appropriate suppressor because it already governs all interactive prompts in WinGet. A new flag is not warranted.
VERBOSE: Publisher message (PreInstall): This package requires 2 GB of disk space and will modify your PATH.
262
+
VERBOSE: Manifest author message (PreInstall): This package requires 2 GB of disk space and will modify your PATH.
263
263
```
264
264
265
265
Post-action messages are written to the information stream (`Write-Information`) so they appear by default but can be suppressed with `-InformationAction SilentlyContinue`.
@@ -281,7 +281,7 @@ This allows scripts to programmatically inspect messages after an operation:
Write-Host "Note from publisher: $($result.UserMessages.PostInstall)" -ForegroundColor Yellow
284
+
Write-Host "Note from manifest author: $($result.UserMessages.PostInstall)" -ForegroundColor Yellow
285
285
}
286
286
```
287
287
@@ -397,14 +397,14 @@ Existing manifests are unaffected. `UserMessages` is entirely optional.
397
397
398
398
### Pre-Action Message Display
399
399
400
-
Pre-action messages are displayed in a visually distinct block before the operation begins. The message is attributed to the package publisher to establish trust context.
400
+
Pre-action messages are displayed in a visually distinct block before the operation begins. The message is attributed to the manifest author to establish trust context.
401
401
402
402
```
403
403
Found Example App [Publisher.ExampleApp] v2.0.0
404
404
This application is licensed to you by its owner.
405
405
Microsoft is not responsible for, nor does it grant any licenses to, third-party packages.
406
406
407
-
The following information has been provided by the package publisher:
407
+
The following information has been provided by the manifest author:
408
408
409
409
This package requires 2 GB of disk space and will modify your PATH.
410
410
@@ -423,7 +423,7 @@ Successfully installed Example App [Publisher.ExampleApp] v2.0.0
423
423
424
424
### Message Attribution
425
425
426
-
All messages include clear attribution language ("provided by the package publisher") to ensure users understand the content originates from the manifest author, not from Microsoft or WinGet. This is critical for trust and security.
426
+
All messages include clear attribution language ("provided by the manifest author") to ensure users understand the content originates from the manifest author, not from Microsoft or WinGet. This distinction is important because in the WinGet community repository, manifests are frequently authored by community contributors rather than the software publisher. This is critical for trust and security.
427
427
428
428
### Localization
429
429
@@ -441,7 +441,7 @@ Messages in locale manifests override those in the defaultLocale manifest on a p
441
441
### Security
442
442
443
443
- **Phishing and social engineering:** Pre-action messages create a stronger social-engineering surface than post-action notes because they appear before the user commits to an action. A malicious manifest author could craft a message like "Enter your password at https://evil.example.com to continue." Mitigations:
444
-
- Clear attribution language ("provided by the package publisher") helps users assess trust.
444
+
- Clear attribution language ("provided by the manifest author") helps users assess trust.
445
445
- Content validation in the winget-pkgs pipeline strips or rejects ANSI escape sequences and control characters.
446
446
- The winget-pkgs community review process provides human review of manifest content.
447
447
- Future enhancement: automated content moderation for suspicious URLs or social-engineering patterns.
0 commit comments