Reorder language guides and reposition category in docs nav

docs/docs/guides/index.md

@@ -27,36 +27,36 @@ agent works from. See [Agent Skills](/agent-skills) for setup.
 | [Go](/guides/go) | Yes | `go.mod` |
 | [Ruby](/guides/ruby) | Yes | `Gemfile` |
 | [Rust](/guides/rust) | Yes | `Cargo.toml` |
-| [Elixir](/guides/elixir) | No | `Dockerfile.miren` |
-| [Gleam](/guides/gleam) | No | `Dockerfile.miren` |
-| [Crystal](/guides/crystal) | No | `Dockerfile.miren` |
-| [Zig](/guides/zig) | No | `Dockerfile.miren` |
-| [Deno](/guides/deno) | No | `Dockerfile.miren` |
-| [Nim](/guides/nim) | No | `Dockerfile.miren` |
-| [C](/guides/c) | No | `Dockerfile.miren` |
-| [C++](/guides/cpp) | No | `Dockerfile.miren` |
-| [Objective-C](/guides/objc) | No | `Dockerfile.miren` |
-| [.NET / C#](/guides/dotnet) | No | `Dockerfile.miren` |
-| [F#](/guides/fsharp) | No | `Dockerfile.miren` |
 | [Java / JVM](/guides/java) | No | `Dockerfile.miren` |
+| [PHP](/guides/php) | No | `Dockerfile.miren` |
+| [.NET / C#](/guides/dotnet) | No | `Dockerfile.miren` |
+| [C++](/guides/cpp) | No | `Dockerfile.miren` |
+| [C](/guides/c) | No | `Dockerfile.miren` |
+| [Deno](/guides/deno) | No | `Dockerfile.miren` |
+| [Elixir](/guides/elixir) | No | `Dockerfile.miren` |
 | [Kotlin](/guides/kotlin) | No | `Dockerfile.miren` |
+| [Swift](/guides/swift) | No | `Dockerfile.miren` |
+| [Dart](/guides/dart) | No | `Dockerfile.miren` |
 | [Scala](/guides/scala) | No | `Dockerfile.miren` |
 | [Clojure](/guides/clojure) | No | `Dockerfile.miren` |
 | [Erlang](/guides/erlang) | No | `Dockerfile.miren` |
-| [PHP](/guides/php) | No | `Dockerfile.miren` |
-| [Perl](/guides/perl) | No | `Dockerfile.miren` |
-| [Raku](/guides/raku) | No | `Dockerfile.miren` |
-| [OCaml](/guides/ocaml) | No | `Dockerfile.miren` |
 | [Haskell](/guides/haskell) | No | `Dockerfile.miren` |
-| [Swift](/guides/swift) | No | `Dockerfile.miren` |
-| [Dart](/guides/dart) | No | `Dockerfile.miren` |
-| [JRuby](/guides/jruby) | No | `Dockerfile.miren` |
-| [TruffleRuby](/guides/truffleruby) | No | `Dockerfile.miren` |
+| [F#](/guides/fsharp) | No | `Dockerfile.miren` |
 | [Julia](/guides/julia) | No | `Dockerfile.miren` |
 | [R](/guides/r) | No | `Dockerfile.miren` |
 | [Lua](/guides/lua) | No | `Dockerfile.miren` |
-| [Klong (K)](/guides/klong) | No | `Dockerfile.miren` |
+| [Perl](/guides/perl) | No | `Dockerfile.miren` |
+| [OCaml](/guides/ocaml) | No | `Dockerfile.miren` |
+| [Crystal](/guides/crystal) | No | `Dockerfile.miren` |
+| [Nim](/guides/nim) | No | `Dockerfile.miren` |
+| [Zig](/guides/zig) | No | `Dockerfile.miren` |
+| [Gleam](/guides/gleam) | No | `Dockerfile.miren` |
+| [Objective-C](/guides/objc) | No | `Dockerfile.miren` |
+| [Raku](/guides/raku) | No | `Dockerfile.miren` |
 | [Common Lisp](/guides/commonlisp) | No | `Dockerfile.miren` |
+| [JRuby](/guides/jruby) | No | `Dockerfile.miren` |
+| [TruffleRuby](/guides/truffleruby) | No | `Dockerfile.miren` |
+| [Klong (K)](/guides/klong) | No | `Dockerfile.miren` |
 | [COBOL](/guides/cobol) | No | `Dockerfile.miren` |
 | [Bash](/guides/bash) | No | `Dockerfile.miren` |
 | [Static sites & SPAs](/guides/static) | No | `Dockerfile.miren` |

docs/sidebars.ts

@@ -29,67 +29,6 @@ const sidebars: SidebarsConfig = {
         'pr-environments',
       ],
     },
-    {
-      type: 'category',
-      label: 'Language Guides',
-      // Nearly 40 guides; unfurled they dominate the sidebar. The theme still
-      // auto-expands this category when the reader is on a guide page.
-      collapsed: true,
-      link: {
-        type: 'doc',
-        id: 'guides/index',
-      },
-      items: [
-        'guides/python',
-        'guides/javascript',
-        'guides/go',
-        'guides/ruby',
-        'guides/rust',
-        'guides/elixir',
-        'guides/gleam',
-        'guides/crystal',
-        'guides/zig',
-        'guides/nim',
-        'guides/c',
-        'guides/cpp',
-        'guides/objc',
-        'guides/deno',
-        'guides/dotnet',
-        'guides/fsharp',
-        'guides/java',
-        'guides/kotlin',
-        'guides/scala',
-        'guides/clojure',
-        'guides/erlang',
-        'guides/php',
-        'guides/perl',
-        'guides/raku',
-        'guides/ocaml',
-        'guides/haskell',
-        'guides/swift',
-        'guides/dart',
-        'guides/jruby',
-        'guides/truffleruby',
-        'guides/julia',
-        'guides/r',
-        'guides/lua',
-        'guides/klong',
-        'guides/commonlisp',
-        'guides/cobol',
-        'guides/bash',
-        'guides/static',
-      ],
-    },
-    {
-      type: 'category',
-      label: 'Recipes',
-      collapsed: false,
-      items: [
-        'recipes/hermes-agent',
-        'recipes/amp-runner',
-        'recipes/openhands-agent-server',
-      ],
-    },
     {
       type: 'category',
       label: 'Data & Storage',
@@ -148,6 +87,71 @@ const sidebars: SidebarsConfig = {
         },
       ],
     },
+    {
+      type: 'category',
+      label: 'Language Guides',
+      // Nearly 40 guides; unfurled they dominate the sidebar. The theme still
+      // auto-expands this category when the reader is on a guide page.
+      collapsed: true,
+      items: [
+        {
+          type: 'doc',
+          id: 'guides/index',
+          label: 'Overview',
+        },
+        // Auto-detected stacks first, in rough order of popularity.
+        'guides/python',
+        'guides/javascript',
+        'guides/go',
+        'guides/ruby',
+        'guides/rust',
+        // Dockerfile-based languages, roughly by relevance.
+        'guides/java',
+        'guides/php',
+        'guides/dotnet',
+        'guides/cpp',
+        'guides/c',
+        'guides/deno',
+        'guides/elixir',
+        'guides/kotlin',
+        'guides/swift',
+        'guides/dart',
+        'guides/scala',
+        'guides/clojure',
+        'guides/erlang',
+        'guides/haskell',
+        'guides/fsharp',
+        'guides/julia',
+        'guides/r',
+        'guides/lua',
+        'guides/perl',
+        'guides/ocaml',
+        'guides/crystal',
+        'guides/nim',
+        'guides/zig',
+        'guides/gleam',
+        'guides/objc',
+        'guides/raku',
+        'guides/commonlisp',
+        'guides/jruby',
+        'guides/truffleruby',
+        // Esoteric / niche tail.
+        'guides/klong',
+        'guides/cobol',
+        'guides/bash',
+        'guides/static',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Recipes',
+      collapsed: false,
+      items: [
+        'recipes/hermes-agent',
+        'recipes/amp-runner',
+        'recipes/openhands-agent-server',
+      ],
+    },
     {
       type: 'category',
       label: 'Reference',