docs: reorganize navigation for feature discoverability (#1147)

Restructures the Documentation tab so each group answers one operator
question.

- Split the 12-page "Stacks & Deployments" into Stacks (per-stack work)
  and Deployment (the act of deploying); promote Resources Hub to a
  standalone item.
- Dissolve the 2-page "Platform" junk drawer: Sidebar moves to Stacks,
  Host Console moves to Fleet.
- Rename "Fleet & Multi-Node" to "Fleet"; absorb Node Compatibility
  from Reference. Move Scheduled Operations from Fleet to Automation
  (now a 4-page group covering Scheduled Ops, Auto-Update, Auto-Heal,
  Webhooks).
- Clean up the Reference tab: drop misplaced node-compatibility, move
  root-level security.mdx into reference/, delete the orphan
  reference/verifying-images.mdx after porting its Available Tags
  table into operations/verifying-images.mdx.
- Reorder top-level groups: Operations moves above Reference.
- Rename two misleading page titles: "Deploy Progress Modal" becomes
  "Deploy Progress" (drops the UI implementation leak); "Auto-Update
  Readiness" becomes "Auto-Update Policies" (matches filename and
  sibling "Auto-Heal Policies").

Verified: docs.json parses as valid JSON, 59 disk .mdx files match
59 nav entries with zero orphans and zero broken refs.
This commit is contained in:
Anso
2026-05-21 21:25:23 -04:00
committed by GitHub
parent be22e3ded1
commit 5f7a887ed6
11 changed files with 58 additions and 132 deletions
+37 -37
View File
@@ -95,22 +95,28 @@
"pages": [
"features/overview",
{
"group": "Stacks & Deployments",
"group": "Stacks",
"pages": [
"features/stack-management",
"features/stack-activity",
"features/editor",
"features/stack-file-explorer",
"features/deploy-progress",
"features/resources",
"features/app-store",
"features/atomic-deployments",
"features/deploy-enforcement",
"features/blueprint-model",
"features/git-sources",
"features/stack-labels"
"features/stack-activity",
"features/stack-labels",
"features/sidebar"
]
},
{
"group": "Deployment",
"pages": [
"features/deploy-progress",
"features/atomic-deployments",
"features/deploy-enforcement",
"features/git-sources",
"features/app-store",
"features/blueprint-model"
]
},
"features/resources",
{
"group": "Observability",
"pages": [
@@ -122,7 +128,7 @@
]
},
{
"group": "Fleet & Multi-Node",
"group": "Fleet",
"pages": [
"features/multi-node",
"features/pilot-agent",
@@ -134,7 +140,17 @@
"features/fleet-secrets",
"features/fleet-backups",
"features/remote-updates",
"features/scheduled-operations"
"features/node-compatibility",
"features/host-console"
]
},
{
"group": "Automation",
"pages": [
"features/scheduled-operations",
"features/auto-update-policies",
"features/auto-heal-policies",
"features/webhooks"
]
},
{
@@ -148,34 +164,9 @@
"features/cve-suppressions",
"features/private-registries"
]
},
{
"group": "Automation",
"pages": [
"features/auto-update-policies",
"features/auto-heal-policies",
"features/webhooks"
]
},
{
"group": "Platform",
"pages": [
"features/sidebar",
"features/host-console"
]
}
]
},
{
"group": "Reference",
"pages": [
"reference/settings",
"features/licensing",
"features/node-compatibility",
"security",
"reference/contact"
]
},
{
"group": "Operations",
"pages": [
@@ -187,6 +178,15 @@
"operations/trivy-setup",
"operations/two-factor-admin"
]
},
{
"group": "Reference",
"pages": [
"reference/settings",
"features/licensing",
"reference/security",
"reference/contact"
]
}
]
},