Fix(WEB-9483): Index HTTP Method + Path (GET /<path>) for API Search (#37784)

* feat(search): index API endpoint REST paths in content field

Append the HTTP method and REST path to each API endpoint's search
content so users can find endpoints by typing the path. Capture the
method and path in api-pages-full-index.json and pass them to the
per-endpoint indexer.

* docs(search): comment API endpoint path/method capture

* chore(search): revert API path indexing to baseline

Remove the endpoint path/method indexing changes so this branch builds
the master baseline search.json for diffing. To be re-added later.

* fix(search): dedupe v1/v2 API records by anchorized summary

Compare anchorized summaries in the v1/v2 disambiguation so endpoints
whose translated summaries differ only by punctuation (e.g. trailing
period) still get a unique -v1/-v2 anchor instead of colliding on one
objectID and churning on every sync.

* [empty] trigger build to test updated api

* [test] tweak bits_chat overview wording to verify single-record sync diff

* Revert [test] bits_chat wording change

* Re-add API path/method indexing as a commented, inert toggle

Forward $endpoint_path/$method into api-page-index.json and add a
commented-out append to the content field. Disabled by default (uncomment
one line to enable); output is unchanged from baseline.

* Enable API endpoint path/method indexing in content field

Append "METHOD /path" to each API endpoint record's content so endpoint
REST paths are searchable. Appended at the end to keep it out of the start
of the auto-embedded content.

* Trim stale/low-value comments on API path indexing

Author: onceLearner

layouts/partials/algolia/api-page-index.json

@@ -5,6 +5,8 @@
 {{ $lang := .lang }}
 {{ $api_version := .api_version }} {{/* "v1" or "v2" */}}
 {{ $endpoint_data := .endpoint_data }}
+{{ $endpoint_path := .endpoint_path }}
+{{ $method := .method }}
 {{ $api_v1_translate_actions := .api_v1_translate_actions }}
 {{ $api_v2_translate_actions := .api_v2_translate_actions }}
 
@@ -20,13 +22,17 @@
 {{ $action_data := index $translate_actions_datafile $operationId }}
 {{ $section_header := $action_data.summary }}
 {{ $section_content := $action_data.description }}
+
+{{/* Append "METHOD /path" so the endpoint's REST path is searchable. Kept at the end to stay out of the embedding's truncated input. */}}
+{{ $section_content = printf "%s\n\n%s %s" ($section_content | default "") (upper $method) $endpoint_path | strings.TrimSpace }}
+
 {{ $endpoint_slug := $section_header | anchorize }}
 {{ $full_url := print $permalink $endpoint_slug "/" }}
 {{ $relpermalink = print $relpermalink $endpoint_slug "/" }}
 
 {{/* When the same operationId+summary exists in both v1 and v2, both versions share one endpoint page with version tabs. Disambiguate the records by linking to the tab anchor. */}}
 {{ $other_action := cond (eq $api_version "v1") (index $api_v2_translate_actions $operationId) (index $api_v1_translate_actions $operationId) }}
-{{ if and (ne $other_action nil) (eq $other_action.summary $section_header) }}
+{{ if and (ne $other_action nil) (eq ($other_action.summary | anchorize) ($section_header | anchorize)) }}
     {{ $tab_anchor := (print $section_header "-" $api_version) | anchorize }}
     {{ $full_url = print $full_url "#" $tab_anchor }}
     {{ $relpermalink = print $relpermalink "#" $tab_anchor }}

layouts/partials/algolia/api-pages-full-index.json

@@ -32,10 +32,10 @@
 
         {{/* Get all v1 api actions for this page by matching title with spec data's tag property */}}
         {{ range $endpoint_path, $endpoint_data := $api_v1_data.paths }}
-            {{ range $endpoint_data }}
+            {{ range $method, $action := $endpoint_data }}
                 {{ $tags := slice }}
-                {{ if isset . "tags" }}
-                  {{ $tags = .tags }}
+                {{ if isset $action "tags" }}
+                  {{ $tags = $action.tags }}
                 {{ end }}
 
                 {{ if in $tags $title }}
@@ -47,7 +47,9 @@
                             "title" $title
                             "lang" $lang
                             "api_version" "v1"
-                            "endpoint_data" .
+                            "endpoint_data" $action
+                            "endpoint_path" $endpoint_path
+                            "method" $method
                             "api_v1_translate_actions" $api_v1_translate_actions
                             "api_v2_translate_actions" $api_v2_translate_actions
                         )
@@ -60,10 +62,10 @@
 
         {{/* Get all v2 api actions for this page by matching title with spec data's tag property */}}
         {{ range $endpoint_path, $endpoint_data := $api_v2_data.paths }}
-            {{ range $endpoint_data }}
+            {{ range $method, $action := $endpoint_data }}
                 {{ $tags := slice }}
-                {{ if isset . "tags" }}
-                  {{ $tags = .tags }}
+                {{ if isset $action "tags" }}
+                  {{ $tags = $action.tags }}
                 {{ end }}
 
                 {{ if in $tags $title }}
@@ -75,7 +77,9 @@
                             "title" $title
                             "lang" $lang
                             "api_version" "v2"
-                            "endpoint_data" .
+                            "endpoint_data" $action
+                            "endpoint_path" $endpoint_path
+                            "method" $method
                             "api_v1_translate_actions" $api_v1_translate_actions
                             "api_v2_translate_actions" $api_v2_translate_actions
                         )