From 5be940e4f1c0a6af495f5f789fcad6dd1d042f1b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= <biwanczuk@gmail.com>
Date: Mon, 15 Jun 2026 09:39:36 +0200
Subject: [PATCH] docs: regroup the runtime sidebar, replacing the Advanced
 catch-all

The Advanced group mixed unrelated topics and conflated difficulty with
subject. Move Docker and continuous integration into a new Deploying group
anchored by the deployment hub, move JSX and React into Guides next to web
development, and move the VS Code editor setup into Get started. Split what
remains into Runtime APIs (FFI, WebAssembly, Cron, OpenTelemetry, loader
hooks) and Build tooling (bundling, lint plugins). No pages move on disk;
this only changes sidebar grouping.
---
 runtime/_data.ts | 50 +++++++++++++++++++++++++++++-------------------
 1 file changed, 30 insertions(+), 20 deletions(-)

diff --git a/runtime/_data.ts b/runtime/_data.ts
index 5ab937849..7a6c77001 100644
--- a/runtime/_data.ts
+++ b/runtime/_data.ts
@@ -18,6 +18,10 @@ export const sidebar = [
         title: "Setup your environment",
         href: "/runtime/getting_started/setup_your_environment/",
       },
+      {
+        title: "Deno & VS Code",
+        href: "/runtime/reference/vscode/",
+      },
       {
         title: "Command line interface",
         href: "/runtime/getting_started/command_line_interface/",
@@ -54,6 +58,10 @@ export const sidebar = [
         title: "Web development",
         href: "/runtime/fundamentals/web_dev/",
       },
+      {
+        title: "JSX and React",
+        href: "/runtime/reference/jsx/",
+      },
       {
         title: "HTTP Server",
         href: "/runtime/fundamentals/http_server/",
@@ -112,10 +120,23 @@ export const sidebar = [
         title: "Building CLI apps",
         href: "/runtime/cli_apps/",
       },
+    ],
+  },
+  {
+    title: "Deploying",
+    items: [
       {
-        title: "Deploying your app",
+        title: "Overview",
         href: "/runtime/deploy/",
       },
+      {
+        title: "Docker",
+        href: "/runtime/reference/docker/",
+      },
+      {
+        title: "Continuous integration",
+        href: "/runtime/reference/continuous_integration/",
+      },
     ],
   },
   {
@@ -152,7 +173,7 @@ export const sidebar = [
     ],
   },
   {
-    title: "Advanced",
+    title: "Runtime APIs",
     items: [
       {
         title: "FFI",
@@ -174,29 +195,18 @@ export const sidebar = [
         title: "Loader hooks",
         href: "/runtime/reference/loader_hooks/",
       },
-      {
-        title: "Lint plugins",
-        href: "/runtime/reference/lint_plugins/",
-      },
+    ],
+  },
+  {
+    title: "Build tooling",
+    items: [
       {
         title: "Bundling",
         href: "/runtime/reference/bundling/",
       },
       {
-        title: "Docker",
-        href: "/runtime/reference/docker/",
-      },
-      {
-        title: "Continuous integration",
-        href: "/runtime/reference/continuous_integration/",
-      },
-      {
-        title: "JSX and React",
-        href: "/runtime/reference/jsx/",
-      },
-      {
-        title: "Deno & VS Code",
-        href: "/runtime/reference/vscode/",
+        title: "Lint plugins",
+        href: "/runtime/reference/lint_plugins/",
       },
     ],
   },