fix: Stable search page and results

docusaurus.config.js

@@ -1,4 +1,5 @@
 const path = require("path");
+const platformEnterpriseVersions = require("./platform-enterprise_versions.json");
 import "dotenv/config";
 import platform_enterprise_latest_version from "./platform-enterprise_latest_version.js";
 import {
@@ -7,6 +8,14 @@ import {
   getSeqeraPresetOptions
 } from "@seqera/docusaurus-preset-seqera";
 
+// Build the search filter_by dynamically so old platform-enterprise versions are
+// excluded automatically whenever a new version is added to versions.json.
+// versions.json is ordered newest-first; index 0 is the current/latest version.
+const oldEnterpriseVersionTags = platformEnterpriseVersions
+  .slice(1)
+  .map((v) => `docs-platform-enterprise-${v}`);
+const searchFilterBy = `docusaurus_tag:!=[default,doc_tag_doc_list,blog_posts_list,blog_tags_posts,doc_tags_list,blog_tags_list${oldEnterpriseVersionTags.length ? `,${oldEnterpriseVersionTags.join(",")}` : ""}]`;
+
 export default async function createConfigAsync() {
 
   const changelog = {
@@ -295,15 +304,16 @@ export default async function createConfigAsync() {
             },
           ],
           apiKey: process.env.TYPESENSE_SEARCH_API_KEY,
-          connectionTimeoutSeconds: 2,
+          connectionTimeoutSeconds: 5, // Default value
         },
         typesenseSearchParameters: {
           query_by: 'content,hierarchy.lvl0,hierarchy.lvl1,hierarchy.lvl2,hierarchy.lvl3',
-          group_by: 'url_without_anchor',
+          group_by: 'url',
           group_limit: 1,
-          num_typos: 1,
+          per_page: 20,
+          num_typos: 2,
           prioritize_exact_match: true,
-          filter_by: 'docusaurus_tag:!=[default,doc_tag_doc_list,blog_posts_list,blog_tags_posts,doc_tags_list,blog_tags_list]', // TODO Remove once the scraper is updated
+          filter_by: searchFilterBy, // Old platform-enterprise versions excluded automatically via searchFilterBy above
         },
         contextualSearch: false,
         placeholder: 'Search Seqera docs...',

package.json

@@ -38,7 +38,7 @@
   "dependencies": {
     "@docusaurus/faster": "^3.9.2",
     "@rspack/core": "^1.4.11",
-    "@seqera/docusaurus-preset-seqera": "^1.0.20",
+    "@seqera/docusaurus-preset-seqera": "^1.0.21",
     "image-size": "^2.0.2",
     "postcss-import": "^16.1.1",
     "postcss-loader": "^8.1.1",

src/theme/SearchPage/generalUtils.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTitleFormatter = useTitleFormatter;
+const tslib_1 = require("tslib");
+// Source: https://github.com/facebook/docusaurus/blob/a308fb7c81832cca354192fe2984f52749441249/packages/docusaurus-theme-common/src/utils/generalUtils.ts
+// Context: https://github.com/typesense/docusaurus-theme-search-typesense/issues/27#issuecomment-1415757477
+const useDocusaurusContext_1 = tslib_1.__importDefault(require("@docusaurus/useDocusaurusContext"));
+/**
+ * Formats the page's title based on relevant site config and other contexts.
+ */
+function useTitleFormatter(title) {
+    const { siteConfig } = (0, useDocusaurusContext_1.default)();
+    const { title: siteTitle, titleDelimiter } = siteConfig;
+    return title?.trim().length
+        ? `${title.trim()} ${titleDelimiter} ${siteTitle}`
+        : siteTitle;
+}