From aa00dc2b89b4ddeb91d14b3f655ee4a173eac980 Mon Sep 17 00:00:00 2001
From: Anso <dev@saelix.com>
Date: Wed, 6 May 2026 21:22:18 -0400
Subject: [PATCH] docs: split Features by capability and tighten nav (#956)

Subdivide the 40-page Features sidebar into six capability subgroups
(Stacks & Deployments, Observability, Fleet & Multi-Node, Security &
Identity, Automation, Platform) so users find features by purpose
rather than scrolling a flat list. Move the licensing page into the
Reference group where it belongs and reorder Reference for scan-ability.
Reorder the Operations group by lifecycle: install, upgrade, backup,
troubleshoot, then per-feature admin tools.

Nav-only change. No .mdx files were moved or renamed; every page keeps
its existing URL. Tier badges already inside each page are unchanged.
---
 docs/docs.json | 126 ++++++++++++++++++++++++++++++-------------------
 1 file changed, 78 insertions(+), 48 deletions(-)

diff --git a/docs/docs.json b/docs/docs.json
index 98e7ec3a..00ce7a80 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -94,67 +94,97 @@
             "group": "Features",
             "pages": [
               "features/overview",
-              "features/dashboard",
-              "features/global-search",
-              "features/sidebar",
-              "features/stack-management",
-              "features/stack-activity",
-              "features/editor",
-              "features/stack-file-explorer",
-              "features/deploy-progress",
-              "features/resources",
-              "features/app-store",
-              "features/global-observability",
-              "features/host-console",
-              "features/multi-node",
-              "features/pilot-agent",
-              "features/sencho-mesh",
-              "features/fleet-view",
-              "features/fleet-sync",
-              "features/blueprint-model",
-              "features/remote-updates",
-              "features/stack-labels",
-              "features/alerts-notifications",
-              "features/notification-routing",
-              "features/webhooks",
-              "features/git-sources",
-              "features/rbac",
-              "features/atomic-deployments",
-              "features/fleet-backups",
-              "features/audit-log",
-              "features/api-tokens",
-              "features/private-registries",
-              "features/vulnerability-scanning",
-              "features/deploy-enforcement",
-              "features/cve-suppressions",
-              "features/auto-update-policies",
-              "features/auto-heal-policies",
-              "features/scheduled-operations",
-              "features/sso",
-              "features/two-factor-authentication",
-              "features/licensing"
+              {
+                "group": "Stacks & Deployments",
+                "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"
+                ]
+              },
+              {
+                "group": "Observability",
+                "pages": [
+                  "features/dashboard",
+                  "features/global-search",
+                  "features/global-observability",
+                  "features/alerts-notifications",
+                  "features/notification-routing",
+                  "features/audit-log"
+                ]
+              },
+              {
+                "group": "Fleet & Multi-Node",
+                "pages": [
+                  "features/multi-node",
+                  "features/pilot-agent",
+                  "features/sencho-mesh",
+                  "features/fleet-view",
+                  "features/fleet-sync",
+                  "features/fleet-backups",
+                  "features/remote-updates",
+                  "features/scheduled-operations"
+                ]
+              },
+              {
+                "group": "Security & Identity",
+                "pages": [
+                  "features/two-factor-authentication",
+                  "features/rbac",
+                  "features/sso",
+                  "features/api-tokens",
+                  "features/vulnerability-scanning",
+                  "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": [
-              "security",
-              "features/node-compatibility",
               "reference/settings",
-              "reference/contact",
-              "reference/security-advisories"
+              "features/licensing",
+              "features/node-compatibility",
+              "security",
+              "reference/security-advisories",
+              "reference/contact"
             ]
           },
           {
             "group": "Operations",
             "pages": [
-              "operations/troubleshooting",
-              "operations/backup",
-              "operations/upgrade",
               "operations/self-hosting",
+              "operations/upgrade",
+              "operations/backup",
+              "operations/troubleshooting",
+              "operations/verifying-images",
               "operations/trivy-setup",
-              "operations/two-factor-admin",
-              "operations/verifying-images"
+              "operations/two-factor-admin"
             ]
           }
         ]