Clarify App Installer app vs. App Installer file in overview - #493
Open
Roy (RDMacLachlan) wants to merge 8 commits into
Open
Clarify App Installer app vs. App Installer file in overview#493Roy (RDMacLachlan) wants to merge 8 commits into
Roy (RDMacLachlan) wants to merge 8 commits into
Conversation
Add a disambiguation note to the App Installer section overview page to distinguish the built-in App Installer app (which renders the install UI) from the .appinstaller file (the XML manifest). This resolves the reported confusion between the two "App Installer" concepts. The broader request to add App Installer overview docs is already satisfied by the existing app-installer-root, app-installer-file-overview, app-installer-ui-dialog, and custom-UX pages. Resolves AB#38195555 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Roy (RDMacLachlan)
requested review from
Howard Kapustein (DrusTheAxe) and
John Kennedy (GrantMeStrength)
July 4, 2026 15:48
Contributor
|
Learn Build status updates of commit a3acd27: ✅ Validation status: passed
For more details, please refer to the build report. |
- Drop bold from the App Installer terms; the file uses no bold elsewhere, and the parentheticals already disambiguate the two concepts. - Remove the duplicate Microsoft Store link, which is already linked on the preceding line. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 18e32334-aec6-40fd-a4f8-0631ef4d5840
Contributor
|
Learn Build status updates of commit 422cca3: ✅ Validation status: passed
For more details, please refer to the build report. |
John Kennedy (GrantMeStrength)
previously approved these changes
Jul 28, 2026
Addresses reviewer comment MicrosoftDocs#1: inline-link the first mention of App Installer (the app) to install-update-app-installer.md so readers can reach the app topic directly. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 3f91f4ac-92c5-4012-bacf-5f63908b8716
Contributor
|
Learn Build status updates of commit 300d633: ✅ Validation status: passed
For more details, please refer to the build report. |
Addresses reviewer comment MicrosoftDocs#2 (Windows 10 ?): App Installer supports Windows 10 version 1803 and later and Windows 11, so the title, heading, intro, and tutorial references no longer imply Windows 10 only. Keeps the precise compatibility statement that names both Windows 10 (1803+) and Windows 11. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 3f91f4ac-92c5-4012-bacf-5f63908b8716
Contributor
|
Learn Build status updates of commit dc66c8d: ✅ Validation status: passed
For more details, please refer to the build report. |
Addresses reviewer comment MicrosoftDocs#3: replaces 'things' with 'technologies' in the note that distinguishes the App Installer app from the App Installer file. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 3f91f4ac-92c5-4012-bacf-5f63908b8716
Contributor
|
Learn Build status updates of commit 19e2789: ✅ Validation status: passed
For more details, please refer to the build report. |
Addresses reviewer comment MicrosoftDocs#4: inline-links the first mention of App Installer file to app-installer-file-overview.md and removes the now-redundant trailing pointer to the same page. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 3f91f4ac-92c5-4012-bacf-5f63908b8716
Contributor
|
Learn Build status updates of commit 7c3eca5: ✅ Validation status: passed
For more details, please refer to the build report. |
Addresses reviewer comment MicrosoftDocs#5: replaces 'app package' with 'package' and rewords the App Installer file description to state that it specifies the package location and defines how the package is installed, updated, and repaired. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 3f91f4ac-92c5-4012-bacf-5f63908b8716
Contributor
|
Learn Build status updates of commit f382dd2: ✅ Validation status: passed
For more details, please refer to the build report. |
Follow-up to reviewer comment MicrosoftDocs#5: replaces the remaining 'app package' wording in the intro paragraph and the note bullet with 'package' so the whole overview is consistent. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 3f91f4ac-92c5-4012-bacf-5f63908b8716
Contributor
|
Learn Build status updates of commit 557b3ce: ✅ Validation status: passed
For more details, please refer to the build report. |
Howard Kapustein (DrusTheAxe)
approved these changes
Aug 2, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Resolves the "add App Installer overview docs" request by closing the one residual gap: the confusing overlap between the two "App Installer" concepts.
What & why
The App Installer documentation section is already built out (overview/landing, file overview, UI, custom UX, install-from-web, security, schema reference), so the structural ask from the original bug is satisfied. The remaining actionable item was a reviewer comment that the docs never disambiguate "App Installer app" from "App Installer file", which "can get confusing."
This change adds a short note to the section overview page (
app-installer-root.md) that distinguishes:.appinstaller) — the XML manifest that points to your app package and defines how it is installed and updated.Files
msix-src/app-installer/app-installer-root.mdResolves AB#38195555