docs: restructure the documentation using the Diataxis framework - #438

Open

sintaxasn wants to merge 31 commits into

mainfrom

docs/diataxis-restructure

Commits on Aug 17, 2026

docs: add tutorials section
sintaxasn
committed
a366e79
docs: add how-to guides for the core deployment workflow
sintaxasn
committed
5e6c410
docs: add how-to guides for the user interface
sintaxasn
committed
0c0c3a9
docs: add how-to guides for Intune and Configuration Manager
sintaxasn
committed
2cbe227
docs: add how-to guides for Group Policy configuration
sintaxasn
committed
7a457be
docs: add how-to guides for upgrading, extending and troubleshooting
sintaxasn
committed
9fb12fe
docs: replace deployment concepts with an explanation section
sintaxasn
committed
0a10596
docs: move the remaining Getting Started pages into reference
sintaxasn
committed
259a913
docs: add reference pages for the deployment surface
sintaxasn
committed
8812255
docs: update existing reference pages for the new structure
sintaxasn
committed
d474357
docs: rebuild the sidebars and landing pages around Diataxis
sintaxasn
committed
f6b22f4
chore(deps): update dependencies
sintaxasn
committed
86f48ef
docs: add Welcome dialog screenshots for the style and branding pages
sintaxasn
committed
f09c4b9
docs: add theme-aware screenshots of the toolkit dialogs
sintaxasn
committed
2e90b7f
docs: document the full dialog capability set in the reference
sintaxasn
committed
82c8d57
Slight wording adjustment
sintaxasn
authored
6510bc5

Commits on Aug 18, 2026

Add -PreRelease to install section, since it's needed to get 4.2.0 RC1 which this is tailored for.
Dan Gough
committed
4c20ee6
Add -ZeroConfig switch to New-ADTemplate command, which is needed in 4.2
Dan Gough
committed
b68f6b5
Swap order so Invoke-AppDeployToolkit.exe example comes before PowerShell.exe example, so it's clear this is the recommended option
Dan Gough
committed
9c0cf1f
Correction that Auto is the default, and add Interactive example
Dan Gough
committed
a06c7b9
Add new -ZeroConfig requirement to zeroconfig how-to
Dan Gough
committed
d5db9ea
Add a couple of examples to install-applications
Dan Gough
committed
cf846e6
Explain that default description is pulled from the EXE; soften warning about Intune retries, as it doesn't do this by default
Dan Gough
committed
8772bcb
Remove recommendations to change deferral exit code and remap return codes, and explain in more detail what happens if they do this.
Dan Gough
committed
3f7e25f
Move Chrome example to Tutorials
Dan Gough
committed
98ad1e9
move set-the-log-path-with-group-policy.mdx to Tutorials
Dan Gough
committed
c7e16ca
Line up all slugs to match actual structure; add code to maintain mappings between relocated pages; only show version banner in dev if there's another version of the page
Dan Gough
committed
0432dbe
Move files back to how-to
Dan Gough
committed
e5c8520
Undo metadata changes related to moving tutorials back to how-to
Dan Gough
committed
a57ccc3
Undo recent change to make DocVersionBanner show selectively, refactor so it has minimal changes from the stock component, plus a minor refactor of DocsVersionSelector
Dan Gough
committed
75162b9
Add missing keyboard navigation in DocsVersionSelector for accessibility (implementation taken from the stock component DocsVersionDropdownNavbarItem)
Dan Gough
committed
84a8208