fix(nx-dev): improve docs search ranking and metrics

astro-docs/public/global-scripts.js

@@ -139,6 +139,7 @@
   let lastSearchQuery = '';
   let currentSearchInput = null;
   let inputHandler = null;
+  let resultClickHandler = null;
 
   function sendSearchEvent(eventType, data) {
     pushGtmEvent(eventType, data);
@@ -150,8 +151,8 @@
     clearTimeout(searchDebounceTimer);
     searchDebounceTimer = setTimeout(() => {
       lastSearchQuery = query;
-      sendSearchEvent('search_query', {
-        query: query,
+      sendSearchEvent('search', {
+        search_term: query,
       });
     }, SEARCH_DEBOUNCE_MS);
   }
@@ -175,12 +176,30 @@
           searchInput.addEventListener('input', inputHandler);
           currentSearchInput = searchInput;
         }
+
+        // Track search result clicks via event delegation
+        if (!resultClickHandler) {
+          resultClickHandler = (e) => {
+            const link = e.target.closest('a[href]');
+            if (!link) return;
+            const query = currentSearchInput
+              ? currentSearchInput.value.trim()
+              : '';
+            pushGtmEvent('select_content', {
+              content_type: 'search_result',
+              item_id: link.getAttribute('href'),
+              search_term: query,
+            });
+          };
+          searchDialog.addEventListener('click', resultClickHandler);
+        }
       }
       // If dialog is not found but we have handler, etc. then it must be closed and we should clean up
       else if (currentSearchInput && inputHandler) {
         currentSearchInput.removeEventListener('input', inputHandler);
         currentSearchInput = null;
         inputHandler = null;
+        resultClickHandler = null;
       }
     });
 

astro-docs/sidebar.mts

@@ -825,6 +825,10 @@ const knowledgeBaseGroups: SidebarItems = [
             label: 'Launch templates',
             link: 'reference/nx-cloud/launch-templates',
           },
+          {
+            label: 'Launch template examples',
+            link: 'reference/nx-cloud/launch-template-examples',
+          },
           {
             label: 'Reduce waste in CI',
             link: 'concepts/ci-concepts/reduce-waste',

astro-docs/src/content.config.ts

@@ -12,7 +12,9 @@ const searchSchema = z.object({
     .min(0, 'Search weight cannot be lower than 0')
     .max(10, 'Search weight cannot be higher than 10')
     .optional(),
-  filter: z.string().optional(),
+  filter: z
+    .enum(['type:Concepts', 'type:Features', 'type:Guides', 'type:References'])
+    .optional(),
 });
 
 const customDocsSchema = z

astro-docs/src/content/docs/guides/Nx Cloud/Source Control Integration/github-app-permissions.mdoc

@@ -1,7 +1,7 @@
 ---
 title: GitHub App Permissions
 description: A detailed breakdown of each permission the Nx Cloud GitHub App requires and why.
-filter: 'type:Reference'
+filter: 'type:References'
 ---
 
 The Nx Cloud GitHub App requires the following permissions to provide CI/CD integration and setup experiences. Most information is used transiently during operations and not stored in our systems.