Skip to content

Restructure TOC by audience (Phase 1: navigation)#495

Draft
RDMacLachlan wants to merge 1 commit into
MicrosoftDocs:mainfrom
RDMacLachlan:users/romaclac/docs-restructure-toc
Draft

Restructure TOC by audience (Phase 1: navigation)#495
RDMacLachlan wants to merge 1 commit into
MicrosoftDocs:mainfrom
RDMacLachlan:users/romaclac/docs-restructure-toc

Conversation

@RDMacLachlan

Copy link
Copy Markdown
Collaborator

Summary

Restructures msix-src/toc.yml into seven audience-oriented top-level nodes to optimize navigation for the three target audiences (Development, App repackaging, App Deployment):

  1. Overview and concepts — what MSIX is, containerization, supported platforms, appContainer, flexible virtualization, App-V vs MSIX, package formats
  2. Develop MSIX apps (Development) — from-source, VS packaging, command line, signing, CI/CD, extend, update from code, MSIX SDK
  3. Repackage existing apps (App repackaging) — Packaging Tool setup/use, PSF, post-package tasks, MSIX Toolkit
  4. Deploy and manage MSIX (App Deployment) — deployment planning, App Installer, enterprise/web/consumer distribution, updates, shared package container, MSIX Core
  5. Reference — APIs and schemas
  6. Troubleshooting and validation
  7. Resources — MSIX resources, partners, customer journeys

Scope & safety

  • Navigation-only change. No article files are moved or renamed; no published URLs change; no redirects required.
  • Every article href is preserved — verified programmatically that all 167 distinct hrefs from the previous TOC remain reachable (0 dropped, 0 added). displayName search hints and external ?context=/windows/msix/render links are retained.
  • This is Phase 1 of the docs restructure. Content right-sizing (splitting long articles into 3–4 minute reads and adding how-to + sample coverage per feature) will follow in separate, bounded PRs.

Reorganize msix-src/toc.yml into seven audience-oriented top-level nodes
(Overview and concepts, Develop MSIX apps, Repackage existing apps, Deploy
and manage MSIX, Reference, Troubleshooting and validation, Resources) to
optimize navigation for the Development, App repackaging, and App Deployment
audiences.

This is a navigation-only change: every existing article href is preserved
(167 distinct hrefs, verified against the previous TOC), no files are moved,
and no published URLs change.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 648831a:

✅ Validation status: passed

File Status Preview URL Details
msix-src/toc.yml ✅Succeeded

For more details, please refer to the build report.

@RDMacLachlan
RDMacLachlan marked this pull request as draft July 11, 2026 18:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant