docs: restructure runtime docs by reader intent

_data.json

@@ -1,7 +1,7 @@
 {
   "navigation": [
     {
-      "name": "Docs",
+      "name": "Runtime",
       "href": "/runtime/"
     },
     {

runtime/_data.ts

@@ -4,7 +4,7 @@ import { Sidebar } from "../types.ts";
 
 export const sidebar = [
   {
-    title: "Getting started",
+    title: "Get started",
     items: [
       {
         title: "Welcome to Deno",
@@ -29,76 +29,130 @@ export const sidebar = [
     ],
   },
   {
-    title: "Fundamentals",
+    title: "Guides",
     items: [
       {
-        title: "TypeScript",
-        href: "/runtime/fundamentals/typescript/",
+        title: "Dependency management",
+        href: "/runtime/fundamentals/dependency_management/",
       },
       {
-        title: "Node",
-        href: "/runtime/fundamentals/node/",
+        title: "Web development",
+        href: "/runtime/fundamentals/web_dev/",
+      },
+      {
+        title: "HTTP Server",
+        href: "/runtime/fundamentals/http_server/",
+      },
+      {
+        title: "Testing",
+        href: "/runtime/fundamentals/testing/",
+      },
+      {
+        title: "Linting and formatting",
+        href: "/runtime/fundamentals/linting_and_formatting/",
+      },
+      {
+        title: "Debugging",
+        href: "/runtime/fundamentals/debugging/",
       },
       {
         title: "Migrating from Node",
         href: "/runtime/fundamentals/migrate_from_node/",
       },
+    ],
+  },
+  {
+    title: "Concepts",
+    items: [
+      {
+        title: "TypeScript",
+        href: "/runtime/fundamentals/typescript/",
+      },
+      {
+        title: "Node",
+        href: "/runtime/fundamentals/node/",
+      },
       {
         title: "Security",
         href: "/runtime/fundamentals/security/",
       },
       {
-        title: "Modules and dependencies",
+        title: "Modules",
         href: "/runtime/fundamentals/modules/",
       },
       {
         title: "Configuration",
         href: "/runtime/fundamentals/configuration/",
       },
       {
-        title: "Web development",
-        href: "/runtime/fundamentals/web_dev/",
+        title: "Workspaces",
+        href: "/runtime/fundamentals/workspaces/",
       },
       {
-        title: "Testing",
-        href: "/runtime/fundamentals/testing/",
+        title: "Stability and releases",
+        href: "/runtime/fundamentals/stability_and_releases/",
       },
+    ],
+  },
+  {
+    title: "Advanced",
+    items: [
       {
-        title: "Debugging",
-        href: "/runtime/fundamentals/debugging/",
+        title: "FFI",
+        href: "/runtime/fundamentals/ffi/",
       },
       {
-        title: "Workspaces",
-        href: "/runtime/fundamentals/workspaces/",
+        title: "WebAssembly",
+        href: "/runtime/reference/wasm/",
       },
       {
-        title: "Linting and formatting",
-        href: "/runtime/fundamentals/linting_and_formatting/",
+        title: "Cron",
+        href: "/runtime/fundamentals/cron/",
       },
       {
-        title: "HTTP Server",
-        href: "/runtime/fundamentals/http_server/",
+        title: "OpenTelemetry",
+        href: "/runtime/fundamentals/open_telemetry/",
       },
       {
-        title: "FFI",
-        href: "/runtime/fundamentals/ffi/",
+        title: "Module customization hooks",
+        href: "/runtime/reference/module_hooks/",
       },
       {
-        title: "OpenTelemetry",
-        href: "/runtime/fundamentals/open_telemetry/",
+        title: "Lint plugins",
+        href: "/runtime/reference/lint_plugins/",
       },
       {
-        title: "Cron",
-        href: "/runtime/fundamentals/cron/",
+        title: "Bundling",
+        href: "/runtime/reference/bundling/",
       },
       {
-        title: "Stability and releases",
-        href: "/runtime/fundamentals/stability_and_releases/",
+        title: "Docker",
+        href: "/runtime/reference/docker/",
+      },
+      {
+        title: "Continuous integration",
+        href: "/runtime/reference/continuous_integration/",
+      },
+      {
+        title: "Using JSX and React",
+        href: "/runtime/reference/jsx/",
+      },
+      {
+        title: "Testing code in docs",
+        href: "/runtime/reference/documentation/",
+      },
+      {
+        title: "Deno & VS Code",
+        href: "/runtime/reference/vscode/",
+      },
+      {
+        title: "Deno 1.x to 2.x migration",
+        href: "/runtime/reference/migration_guide/",
       },
     ],
   },
   {
-    title: "Reference guides",
+    title: "Reference",
     items: [
       {
         title: "CLI",
@@ -327,53 +381,17 @@ export const sidebar = [
         title: "Configuring TypeScript",
         href: "/runtime/reference/ts_config_migration/",
       },
-      {
-        title: "Continuous integration",
-        href: "/runtime/reference/continuous_integration/",
-      },
       {
         title: "Environment variables",
         href: "/runtime/reference/env_variables/",
       },
-      {
-        title: "Deno & VS Code",
-        href: "/runtime/reference/vscode/",
-      },
-      {
-        title: "Using JSX and React",
-        href: "/runtime/reference/jsx/",
-      },
-      {
-        title: "Testing code in docs",
-        href: "/runtime/reference/documentation/",
-      },
-      {
-        title: "Bundling",
-        href: "/runtime/reference/bundling/",
-      },
-      {
-        title: "Lint plugins",
-        href: "/runtime/reference/lint_plugins/",
-      },
-      {
-        title: "Module customization hooks",
-        href: "/runtime/reference/module_hooks/",
-      },
-      {
-        title: "WebAssembly",
-        href: "/runtime/reference/wasm/",
-      },
-      {
-        title: "Migration guide",
-        href: "/runtime/reference/migration_guide/",
-      },
       {
         title: "LSP integration",
         href: "/runtime/reference/lsp_integration/",
       },
       {
-        title: "Docker",
-        href: "/runtime/reference/docker/",
+        title: "Lint rules",
+        href: "/lint/",
       },
     ],
   },

runtime/fundamentals/configuration.md

@@ -272,7 +272,7 @@ Read more about
 
 The `lock` field in the `deno.json` file is used to specify configuration of the
 lock file that Deno uses to
-[ensure the integrity of your dependencies](/runtime/fundamentals/modules/#integrity-checking-and-lock-files).
+[ensure the integrity of your dependencies](/runtime/fundamentals/dependency_management/#integrity-checking-and-lock-files).
 A lock file records the exact versions and integrity hashes of the modules your
 project depends on, ensuring that the same versions are used every time the
 project is run, even if the dependencies are updated or changed remotely.