Skip to content

docs(audit): align documentation with current behavior#34

Open
mchave3 wants to merge 2 commits into
mainfrom
docs/audit-accuracy
Open

docs(audit): align documentation with current behavior#34
mchave3 wants to merge 2 commits into
mainfrom
docs/audit-accuracy

Conversation

@mchave3

@mchave3 mchave3 commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Summary

Audit and reorganize the Docusaurus documentation around the real Foundry workflow: media authoring in Foundry OSD, runtime execution through Foundry Connect and Foundry Deploy, and post-WinPE handoff.

Reason

The previous navigation was technically usable but fragmented the product journey. Connect and Deploy were split as separate top-level areas, configuration looked like deployment-time behavior instead of pre-build authoring, technical pages were too prominent, and obsolete legacy Autopilot bridge pages remained in the docs tree.

Main changes

  • Align deployment pipeline, pre-OOBE priority details, wizard labels, Autopilot permissions, and local WinPE debug guidance with current app behavior.
  • Reorganize the sidebar into Start Here, Build Media, Configure Media, Autopilot, Runtime, Reference, and Developer.
  • Add Media Authoring Flow to explain how Foundry OSD settings become generated runtime configuration.
  • Add Logs and Artifacts as the operator-facing collection point for deployment, Autopilot, and pre-OOBE evidence.
  • Move runtime pages under docs/runtime and move the deployment orchestrator into docs/reference.
  • Remove obsolete legacy Autopilot bridge pages instead of keeping fallback stubs.
  • Keep screenshot placeholders where planned screenshots are still needed.

Testing

  • git diff --check
  • npm run typecheck
  • npm run build

Notes: branch only; not merged or squashed.

@mchave3 mchave3 force-pushed the docs/audit-accuracy branch from 4825876 to 360db42 Compare June 9, 2026 15:39
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