docs: update repository boundaries and Agent Canvas architecture

docs.json

@@ -97,6 +97,12 @@
           {
             "group": "Additional Documentation",
             "pages": [
+              {
+                "group": "Sandbox Server",
+                "pages": [
+                  "openhands/usage/api/v1"
+                ]
+              },
               {
                 "group": "V0 Reference",
                 "pages": [
@@ -259,40 +265,62 @@
         "tab": "Agent Canvas",
         "pages": [
           "openhands/usage/agent-canvas/overview",
-          "openhands/usage/agent-canvas/setup",
-          "openhands/usage/agent-canvas/first-time-setup",
-          "openhands/usage/agent-canvas/llm-profiles",
-          "openhands/usage/agent-canvas/conversations",
-          "openhands/usage/agent-canvas/agent-profiles",
-          "openhands/usage/agent-canvas/plugins",
-          "openhands/usage/agent-canvas/managing-automations",
+          "openhands/usage/agent-canvas/architecture",
+          {
+            "group": "Install Canvas",
+            "pages": [
+              "openhands/usage/agent-canvas/setup",
+              "openhands/usage/agent-canvas/first-time-setup"
+            ]
+          },
           {
-            "group": "Pre-built Automations",
+            "group": "Automations",
             "pages": [
+              "openhands/usage/agent-canvas/managing-automations",
               "openhands/usage/agent-canvas/prebuilt-automations",
               "openhands/usage/agent-canvas/prebuilt/github-pr-review",
               "openhands/usage/agent-canvas/prebuilt/github-repo-monitor",
               "openhands/usage/agent-canvas/prebuilt/slack-channel-monitor"
             ]
           },
           {
-            "group": "Backends",
+            "group": "Use Canvas",
+            "pages": [
+              "openhands/usage/agent-canvas/conversations",
+              "openhands/usage/agent-canvas/agent-profiles",
+              "openhands/usage/agent-canvas/llm-profiles",
+              "openhands/usage/agent-canvas/acp-agents",
+              "openhands/usage/agent-canvas/plugins",
+              "openhands/usage/agent-canvas/critic",
+              "openhands/usage/agent-canvas/customize-and-settings",
+              "openhands/usage/agent-canvas/mobile-access"
+            ]
+          },
+          {
+            "group": "Connect Backends",
             "pages": [
               "openhands/usage/agent-canvas/backends",
               "openhands/usage/agent-canvas/backend-setup/local",
+              "openhands/usage/agent-canvas/backend-setup/remote",
+              "openhands/usage/agent-canvas/backend-setup/cloud"
+            ]
+          },
+          {
+            "group": "Self-Host Backend Services",
+            "pages": [
               "openhands/usage/agent-canvas/backend-setup/vm",
               "openhands/usage/agent-canvas/backend-setup/docker",
               "openhands/usage/agent-canvas/backend-setup/kubernetes",
-              "openhands/usage/agent-canvas/backend-setup/cloud",
               "openhands/usage/agent-canvas/backend-setup/modal"
             ]
           },
-          "openhands/usage/agent-canvas/customize-and-settings",
-          "openhands/usage/agent-canvas/mobile-access",
-          "openhands/usage/agent-canvas/critic",
-          "openhands/usage/agent-canvas/acp-agents",
-          "openhands/usage/agent-canvas/development",
-          "openhands/usage/agent-canvas/troubleshooting"
+          {
+            "group": "Contribute And Troubleshoot",
+            "pages": [
+              "openhands/usage/agent-canvas/development",
+              "openhands/usage/agent-canvas/troubleshooting"
+            ]
+          }
         ]
       },
       {
@@ -442,7 +470,6 @@
           {
             "group": "Settings",
             "pages": [
-              "openhands/usage/settings/integrations-settings",
               "openhands/usage/settings/api-keys-settings"
             ]
           },
@@ -459,8 +486,7 @@
                 "group": "Cloud API",
                 "pages": [
                   "openhands/usage/cloud/cloud-api",
-                  "openhands/usage/cloud/plugin-launcher",
-                  "openhands/usage/api/v1"
+                  "openhands/usage/cloud/plugin-launcher"
                 ]
               }
             ]
@@ -542,13 +568,13 @@
     "links": [],
     "primary": {
       "type": "github",
-      "href": "https://github.com/OpenHands/OpenHands"
+      "href": "https://github.com/orgs/OpenHands/repositories"
     }
   },
   "footer": {
     "socials": {
       "slack": "https://openhands.dev/joinslack",
-      "github": "https://github.com/OpenHands/OpenHands"
+      "github": "https://github.com/OpenHands"
     },
     "links": [
       {

enterprise/enterprise-vs-oss.mdx

@@ -20,9 +20,9 @@
 | Secrets, MCP, skills | ✓ | ✓ | ✓ | ✓ |
 | LLM Profiles | ✓ | ✓ | ✓ | ✓ |
 | [**AUTOMATIONS**](/openhands/usage/automations/overview) |  |  |  |  |
 | Scheduled automations | ✓ | ✓ | ✓ | ✓ |
 | Polling automations (w/ conditional logic) | ✓ | ✓ | ✓ | ✓ |
 | Event-driven automations | — | ✓ VM must be reachable | ✓ | ✓ |
 | **SANDBOXING & SCALE** |  |  |  |  |
 | Isolated sandboxes | — | On Roadmap | ✓ | ✓ |
 | Scalable, always-on agents | — | — | ✓ | ✓ |
@@ -30,9 +30,9 @@
 | Use OpenHands in Slack, GitHub, GitLab | ✓ | ✓ | ✓ | ✓ |
 | One-click integrations | — | — | ✓ | ✓ |
 | Authentication & authorization | — | — | ✓ | ✓ |
 | Role-based access control | — | — | ✓ | ✓ Keycloak |
 | [Multi-user organizations](/openhands/usage/cloud/organizations/overview) | — | — | ✓ | ✓ |
 | Enforce default LLMs | — | — | ✓ | ✓ |
 | **ENTERPRISE** |  |  |  |  |
 | SAML | — | — | — | ✓ |
 | Custom runtime images | — | — | — | ✓ |
@@ -57,7 +57,7 @@
 OpenHands Enterprise is the right choice when you need:
 
 - **Multi-use RBAC** — Manage multiple users from a single platform
 - **Platform integrations** — Invoke OpenHands directly from Slack, Jira, GitHub, GitLab, or Bitbucket
 - **Scalability** — Run unlimited parallel agent conversations without local resource constraints
 - **Enterprise security** — SAML authentication, RBAC, and centralized audit logs
 - **Usage Monitoring** — Track and enforce budgets; monitor usage across all users
@@ -68,9 +68,9 @@
   <Card
     title="Try Agent Canvas"
     icon="desktop"
-    href="/openhands/usage/run-openhands/local-setup#start-the-app"
+    href="/openhands/usage/agent-canvas/setup"
   >
-    Get started with OpenHands on your local machine using Docker or the CLI launcher.
+    Install Agent Canvas locally with npm, npx, Docker, or a source checkout.
   </Card>
   <Card
     title="Contact Enterprise Sales"