From ff416f8e7ca32acf65e0f93d960dcb4cfc4db1db Mon Sep 17 00:00:00 2001
From: Mike Odnis <engineer@resq.software>
Date: Fri, 24 Jul 2026 03:10:20 -0400
Subject: [PATCH] feat(search): rebalance in-product search ranking and enforce
 trailing-slash URLs

The generated SDK reference tree is 769 files against 41 handwritten pages,
so typedoc/doxygen output dominates in-product search and buries the guides.
Fix the ranking at the navigation-group level rather than stamping frontmatter
across the generated tree, which the sync automation would overwrite.

- boost 4 on the "Start here" group in all five locales
- boost 2 on the handwritten SDK and API reference landing groups
- boost 0.3 on "Generated Package References" to de-prioritise without
  removing it (searchable: false would also strip it from AI assistant
  context, which we want to keep)
- seo.trailingSlash: true for consistent canonical, og:url and sitemap URLs
  across the five locales
- add download-spec to the contextual menu; it self-scopes to API reference
  pages and exposes specs/coordination.json and specs/infrastructure.json
---
 docs.json | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs.json b/docs.json
index 036d18ac..8f374246 100644
--- a/docs.json
+++ b/docs.json
@@ -36,6 +36,7 @@
             "groups": [
               {
                 "group": "Start here",
+                "boost": 4,
                 "pages": [
                   "index",
                   "concepts",
@@ -51,12 +52,14 @@
             "groups": [
               {
                 "group": "Overview",
+                "boost": 2,
                 "pages": [
                   "sdks/index"
                 ]
               },
               {
                 "group": "Languages",
+                "boost": 2,
                 "pages": [
                   "sdks/typescript",
                   "sdks/python",
@@ -67,6 +70,7 @@
               },
               {
                 "group": "Generated Package References",
+                "boost": 0.3,
                 "pages": [
                   {
                     "group": "TypeScript",
@@ -2261,6 +2265,7 @@
             "groups": [
               {
                 "group": "Overview",
+                "boost": 2,
                 "pages": [
                   "api-reference/introduction"
                 ]
@@ -2285,6 +2290,7 @@
             "groups": [
               {
                 "group": "Empieza aquí",
+                "boost": 4,
                 "pages": [
                   "es/index",
                   "es/concepts",
@@ -2324,6 +2330,7 @@
             "groups": [
               {
                 "group": "ابدأ من هنا",
+                "boost": 4,
                 "pages": [
                   "ar/index",
                   "ar/concepts",
@@ -2363,6 +2370,7 @@
             "groups": [
               {
                 "group": "यहाँ शुरू करें",
+                "boost": 4,
                 "pages": [
                   "hi/index",
                   "hi/concepts",
@@ -2402,6 +2410,7 @@
             "groups": [
               {
                 "group": "从这里开始",
+                "boost": 4,
                 "pages": [
                   "zh/index",
                   "zh/concepts",
@@ -2466,6 +2475,7 @@
   },
   "seo": {
     "indexing": "all",
+    "trailingSlash": true,
     "metatags": {
       "og:title": "ResQ Docs — Tactical OS for Autonomous Disaster Response",
       "og:description": "Official documentation for ResQ Tactical OS — the decentralized kinetic operating system for autonomous disaster response. Mesh-networked coordination when infrastructure fails.",
@@ -2540,6 +2550,7 @@
     "options": [
       "copy",
       "view",
+      "download-spec",
       "chatgpt",
       "claude",
       "mcp",