From ad67a33d099cc4689778f37778bf2b169a525f26 Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Sun, 8 Oct 2023 11:22:23 +0200
Subject: [PATCH 01/21] fix(search-backend-node): non-string field hightlight

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 .../search-backend-node/src/engines/LunrSearchEngine.ts   | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/plugins/search-backend-node/src/engines/LunrSearchEngine.ts b/plugins/search-backend-node/src/engines/LunrSearchEngine.ts
index ae5a541e81..02bd6f7fd7 100644
--- a/plugins/search-backend-node/src/engines/LunrSearchEngine.ts
+++ b/plugins/search-backend-node/src/engines/LunrSearchEngine.ts
@@ -329,11 +329,11 @@ export function parseHighlightFields({
 
       const highlightedField = positions.reduce((content, pos) => {
         return (
-          `${content.substring(0, pos[0])}${preTag}` +
-          `${content.substring(pos[0], pos[0] + pos[1])}` +
-          `${postTag}${content.substring(pos[0] + pos[1])}`
+          `${content.toString().substring(0, pos[0])}${preTag}` +
+          `${content.toString().substring(pos[0], pos[0] + pos[1])}` +
+          `${postTag}${content.toString().substring(pos[0] + pos[1])}`
         );
-      }, doc[field]);
+      }, doc[field] ?? '');
 
       return [field, highlightedField];
     }),

From e8839fe017b46cf49ff2eede1776e819df205e8c Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Sun, 8 Oct 2023 11:26:12 +0200
Subject: [PATCH 02/21] feat(stackoverflow-backend): get request params from
 config

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 plugins/stack-overflow-backend/config.d.ts          |  7 +++++++
 .../search/StackOverflowQuestionsCollatorFactory.ts | 13 +++++++++++--
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/plugins/stack-overflow-backend/config.d.ts b/plugins/stack-overflow-backend/config.d.ts
index b97f237c19..613a7aa887 100644
--- a/plugins/stack-overflow-backend/config.d.ts
+++ b/plugins/stack-overflow-backend/config.d.ts
@@ -40,5 +40,12 @@ export interface Config {
      * @visibility secret
      */
     apiAccessToken?: string;
+
+    /**
+     * Type representing the request parameters.
+     */
+    requestParams?: {
+      [key: string]: string | string[] | number;
+    };
   };
 }
diff --git a/plugins/stack-overflow-backend/src/search/StackOverflowQuestionsCollatorFactory.ts b/plugins/stack-overflow-backend/src/search/StackOverflowQuestionsCollatorFactory.ts
index c5f8a8c16b..cf1e56cb28 100644
--- a/plugins/stack-overflow-backend/src/search/StackOverflowQuestionsCollatorFactory.ts
+++ b/plugins/stack-overflow-backend/src/search/StackOverflowQuestionsCollatorFactory.ts
@@ -54,7 +54,7 @@ export type StackOverflowQuestionsCollatorFactoryOptions = {
   apiKey?: string;
   apiAccessToken?: string;
   teamName?: string;
-  requestParams: StackOverflowQuestionsRequestParams;
+  requestParams?: StackOverflowQuestionsRequestParams;
   logger: Logger;
 };
 
@@ -81,7 +81,11 @@ export class StackOverflowQuestionsCollatorFactory
     this.apiAccessToken = options.apiAccessToken;
     this.teamName = options.teamName;
     this.maxPage = options.maxPage;
-    this.requestParams = options.requestParams;
+    this.requestParams = options.requestParams ?? {
+      tagged: ['backstage'],
+      site: 'stackoverflow',
+      pagesize: 100,
+    };
     this.logger = options.logger.child({ documentType: this.type });
   }
 
@@ -98,12 +102,17 @@ export class StackOverflowQuestionsCollatorFactory
       config.getOptionalString('stackoverflow.baseUrl') ||
       'https://api.stackexchange.com/2.3';
     const maxPage = options.maxPage || 100;
+    const requestParams =
+      config.getOptional<StackOverflowQuestionsRequestParams>(
+        'stackoverflow.requestParams',
+      );
     return new StackOverflowQuestionsCollatorFactory({
       baseUrl,
       maxPage,
       apiKey,
       apiAccessToken,
       teamName,
+      requestParams,
       ...options,
     });
   }

From 43bcd9fcead0ae6cc9ac4a3e2b5e7f2441fa2ba5 Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Sun, 8 Oct 2023 11:27:50 +0200
Subject: [PATCH 03/21] feat(stackoverflow-backend): migrate collator to
 backend system

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 .../alpha-api-report.md                       | 11 +++
 plugins/stack-overflow-backend/api-report.md  |  2 +-
 plugins/stack-overflow-backend/package.json   | 23 ++++--
 plugins/stack-overflow-backend/src/alpha.ts   | 70 +++++++++++++++++++
 4 files changed, 101 insertions(+), 5 deletions(-)
 create mode 100644 plugins/stack-overflow-backend/alpha-api-report.md
 create mode 100644 plugins/stack-overflow-backend/src/alpha.ts

diff --git a/plugins/stack-overflow-backend/alpha-api-report.md b/plugins/stack-overflow-backend/alpha-api-report.md
new file mode 100644
index 0000000000..93d4cfe5e5
--- /dev/null
+++ b/plugins/stack-overflow-backend/alpha-api-report.md
@@ -0,0 +1,11 @@
+## API Report File for "@backstage/plugin-stack-overflow-backend"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+import { BackendFeature } from '@backstage/backend-plugin-api';
+
+// @alpha
+const _default: () => BackendFeature;
+export default _default;
+```
diff --git a/plugins/stack-overflow-backend/api-report.md b/plugins/stack-overflow-backend/api-report.md
index 8c601399c1..e8fd710cf6 100644
--- a/plugins/stack-overflow-backend/api-report.md
+++ b/plugins/stack-overflow-backend/api-report.md
@@ -45,7 +45,7 @@ export type StackOverflowQuestionsCollatorFactoryOptions = {
   apiKey?: string;
   apiAccessToken?: string;
   teamName?: string;
-  requestParams: StackOverflowQuestionsRequestParams;
+  requestParams?: StackOverflowQuestionsRequestParams;
   logger: Logger;
 };
 
diff --git a/plugins/stack-overflow-backend/package.json b/plugins/stack-overflow-backend/package.json
index 320d35d3b6..53857082d2 100644
--- a/plugins/stack-overflow-backend/package.json
+++ b/plugins/stack-overflow-backend/package.json
@@ -5,9 +5,22 @@
   "types": "src/index.ts",
   "license": "Apache-2.0",
   "publishConfig": {
-    "access": "public",
-    "main": "dist/index.cjs.js",
-    "types": "dist/index.d.ts"
+    "access": "public"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./alpha": "./src/alpha.ts",
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "alpha": [
+        "src/alpha.ts"
+      ],
+      "package.json": [
+        "package.json"
+      ]
+    }
   },
   "backstage": {
     "role": "backend-plugin"
@@ -33,7 +46,10 @@
   },
   "dependencies": {
     "@backstage/backend-common": "workspace:^",
+    "@backstage/backend-plugin-api": "workspace:^",
+    "@backstage/backend-tasks": "workspace:^",
     "@backstage/config": "workspace:^",
+    "@backstage/plugin-search-backend-node": "workspace:^",
     "@backstage/plugin-search-common": "workspace:^",
     "node-fetch": "^2.6.7",
     "qs": "^6.9.4",
@@ -42,7 +58,6 @@
   "devDependencies": {
     "@backstage/backend-test-utils": "workspace:^",
     "@backstage/cli": "workspace:^",
-    "@backstage/plugin-search-backend-node": "workspace:^",
     "msw": "^1.0.0"
   },
   "files": [
diff --git a/plugins/stack-overflow-backend/src/alpha.ts b/plugins/stack-overflow-backend/src/alpha.ts
new file mode 100644
index 0000000000..897cbd1ea2
--- /dev/null
+++ b/plugins/stack-overflow-backend/src/alpha.ts
@@ -0,0 +1,70 @@
+/*
+ * Copyright 2023 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { loggerToWinstonLogger } from '@backstage/backend-common';
+import { readTaskScheduleDefinitionFromConfig } from '@backstage/backend-tasks';
+import {
+  coreServices,
+  createBackendModule,
+} from '@backstage/backend-plugin-api';
+import { searchIndexRegistryExtensionPoint } from '@backstage/plugin-search-backend-node/alpha';
+import { StackOverflowQuestionsCollatorFactory } from './search';
+
+/**
+ * @packageDocumentation
+ * A module for the search backend that exports Stack Overflow modules.
+ */
+
+/**
+ * Search backend module for the Stack Overflow index.
+ *
+ * @alpha
+ */
+export default createBackendModule({
+  moduleId: 'stackoverflowCollator',
+  pluginId: 'search',
+  register(env) {
+    env.registerInit({
+      deps: {
+        config: coreServices.rootConfig,
+        logger: coreServices.logger,
+        discovery: coreServices.discovery,
+        scheduler: coreServices.scheduler,
+        indexRegistry: searchIndexRegistryExtensionPoint,
+      },
+      async init({ config, logger, scheduler, indexRegistry }) {
+        const defaultSchedule = {
+          frequency: { minutes: 10 },
+          timeout: { minutes: 15 },
+          initialDelay: { seconds: 3 },
+        };
+
+        const schedule = config.has('search.collators.stackoverflow.schedule')
+          ? readTaskScheduleDefinitionFromConfig(
+              config.getConfig('search.collators.stackoverflow.schedule'),
+            )
+          : defaultSchedule;
+
+        indexRegistry.addCollator({
+          schedule: scheduler.createScheduledTaskRunner(schedule),
+          factory: StackOverflowQuestionsCollatorFactory.fromConfig(config, {
+            logger: loggerToWinstonLogger(logger),
+          }),
+        });
+      },
+    });
+  },
+});

From 41c2cdf23358e13b29303e92df0da3c4674fd9cb Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Sun, 8 Oct 2023 11:32:36 +0200
Subject: [PATCH 04/21] feat(backend-next): install stack overflow search
 module

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 packages/backend-next/package.json | 1 +
 packages/backend-next/src/index.ts | 1 +
 2 files changed, 2 insertions(+)

diff --git a/packages/backend-next/package.json b/packages/backend-next/package.json
index 69aa81a9cb..41864907e5 100644
--- a/packages/backend-next/package.json
+++ b/packages/backend-next/package.json
@@ -56,6 +56,7 @@
     "@backstage/plugin-search-backend-module-techdocs": "workspace:^",
     "@backstage/plugin-search-backend-node": "workspace:^",
     "@backstage/plugin-sonarqube-backend": "workspace:^",
+    "@backstage/plugin-stack-overflow-backend": "workspace:^",
     "@backstage/plugin-techdocs-backend": "workspace:^",
     "@backstage/plugin-todo-backend": "workspace:^"
   },
diff --git a/packages/backend-next/src/index.ts b/packages/backend-next/src/index.ts
index bdfbc2c26b..15f5ca9c38 100644
--- a/packages/backend-next/src/index.ts
+++ b/packages/backend-next/src/index.ts
@@ -46,6 +46,7 @@ backend.add(import('@backstage/plugin-search-backend-module-explore/alpha'));
 backend.add(import('@backstage/plugin-search-backend-module-techdocs/alpha'));
 backend.add(import('@backstage/plugin-search-backend/alpha'));
 backend.add(import('@backstage/plugin-techdocs-backend/alpha'));
+backend.add(import('@backstage/plugin-stack-overflow-backend/alpha'));
 backend.add(import('@backstage/plugin-todo-backend'));
 backend.add(import('@backstage/plugin-sonarqube-backend'));
 

From b148cdc8dbfc8889371ee221a2a1ba6075a16cf2 Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Sun, 8 Oct 2023 11:38:24 +0200
Subject: [PATCH 05/21] feat(stackoverflow): migrate to new frontend system

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 plugins/stack-overflow/alpha-api-report.md | 13 ++++++
 plugins/stack-overflow/package.json        | 20 +++++++--
 plugins/stack-overflow/src/alpha.tsx       | 48 ++++++++++++++++++++++
 3 files changed, 78 insertions(+), 3 deletions(-)
 create mode 100644 plugins/stack-overflow/alpha-api-report.md
 create mode 100644 plugins/stack-overflow/src/alpha.tsx

diff --git a/plugins/stack-overflow/alpha-api-report.md b/plugins/stack-overflow/alpha-api-report.md
new file mode 100644
index 0000000000..84d7616759
--- /dev/null
+++ b/plugins/stack-overflow/alpha-api-report.md
@@ -0,0 +1,13 @@
+## API Report File for "@backstage/plugin-stack-overflow"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+import { BackstagePlugin } from '@backstage/frontend-plugin-api';
+
+// @alpha (undocumented)
+const _default: BackstagePlugin;
+export default _default;
+
+// (No @packageDocumentation comment for this package)
+```
diff --git a/plugins/stack-overflow/package.json b/plugins/stack-overflow/package.json
index f60800d1f9..431f8a5b80 100644
--- a/plugins/stack-overflow/package.json
+++ b/plugins/stack-overflow/package.json
@@ -5,9 +5,22 @@
   "types": "src/index.ts",
   "license": "Apache-2.0",
   "publishConfig": {
-    "access": "public",
-    "main": "dist/index.esm.js",
-    "types": "dist/index.d.ts"
+    "access": "public"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./alpha": "./src/alpha.tsx",
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "alpha": [
+        "src/alpha.tsx"
+      ],
+      "package.json": [
+        "package.json"
+      ]
+    }
   },
   "backstage": {
     "role": "frontend-plugin"
@@ -32,6 +45,7 @@
     "@backstage/config": "workspace:^",
     "@backstage/core-components": "workspace:^",
     "@backstage/core-plugin-api": "workspace:^",
+    "@backstage/frontend-plugin-api": "workspace:^",
     "@backstage/plugin-home-react": "workspace:^",
     "@backstage/plugin-search-common": "workspace:^",
     "@backstage/plugin-search-react": "workspace:^",
diff --git a/plugins/stack-overflow/src/alpha.tsx b/plugins/stack-overflow/src/alpha.tsx
new file mode 100644
index 0000000000..18f0a0df1c
--- /dev/null
+++ b/plugins/stack-overflow/src/alpha.tsx
@@ -0,0 +1,48 @@
+/*
+ * Copyright 2023 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { configApiRef, createApiFactory } from '@backstage/core-plugin-api';
+import {
+  createApiExtension,
+  createPlugin,
+} from '@backstage/frontend-plugin-api';
+import { createSearchResultListItemExtension } from '@backstage/plugin-search-react/alpha';
+import { StackOverflowClient, stackOverflowApiRef } from './api';
+
+/** @alpha */
+const StackOverflowApi = createApiExtension({
+  factory: createApiFactory({
+    api: stackOverflowApiRef,
+    deps: { configApi: configApiRef },
+    factory: ({ configApi }) => StackOverflowClient.fromConfig(configApi),
+  }),
+});
+
+/** @alpha */
+const StackOverflowSearchResultListItem = createSearchResultListItemExtension({
+  id: 'stack-overflow',
+  predicate: result => result.type === 'stack-overflow',
+  component: () =>
+    import('./search/StackOverflowSearchResultListItem').then(
+      m => m.StackOverflowSearchResultListItem,
+    ),
+});
+
+/** @alpha */
+export default createPlugin({
+  id: 'stack-overflow',
+  extensions: [StackOverflowApi, StackOverflowSearchResultListItem],
+});

From 8b44bf58f2380d4d0c3806227325397aa5a04259 Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Sun, 8 Oct 2023 11:41:12 +0200
Subject: [PATCH 06/21] feat(search): add stackoverflow to types accordion

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 plugins/search/src/alpha.tsx | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/plugins/search/src/alpha.tsx b/plugins/search/src/alpha.tsx
index 14e7067dfa..913a96d094 100644
--- a/plugins/search/src/alpha.tsx
+++ b/plugins/search/src/alpha.tsx
@@ -69,6 +69,25 @@ import { SearchType } from './components/SearchType';
 import { UrlUpdater } from './components/SearchPage/SearchPage';
 import { convertLegacyRouteRef } from '@backstage/core-plugin-api/alpha';
 
+/** @internal */
+const StackOverflowIcon = () => {
+  return (
+    <svg
+      viewBox="0 0 125 125"
+      width="25"
+      height="25"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      <path d="M84.021 75.825v31H11v-31H0v42h95v-42H84.021z" fill="#BCBBBB" />
+      <path
+        d="M21.057 96.825H74v-10H21.057v10zm1.058-23.915l51.428 10.794 2.117-10.265L24.23 62.645 22.115 72.91zm6.773-24.656l47.618 22.222 4.445-9.524L33.33 38.73l-4.444 9.524zm13.227-23.386l40.423 33.65 6.773-8.042-40.53-33.65-6.666 8.042zM68.147 0L59.68 6.243l31.323 42.222 8.465-6.243L68.147 0z"
+        fill="#F48024"
+      />
+    </svg>
+  );
+};
+
 /** @alpha */
 export const SearchApi = createApiExtension({
   factory: {
@@ -153,6 +172,11 @@ export const SearchPage = createPageExtension({
                         name: 'Architecture Decision Records',
                         icon: <DocsIcon />,
                       },
+                      {
+                        value: 'stack-overflow',
+                        name: 'Stack Overflow',
+                        icon: <StackOverflowIcon />,
+                      },
                     ]}
                   />
                   <Paper className={classes.filters}>

From b168d7e7ea16c440d26d68fc0663c5ce6ece71a3 Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Sun, 8 Oct 2023 12:55:20 +0200
Subject: [PATCH 07/21] chore: add changeset files

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 .changeset/flat-ducks-buy.md    | 5 +++++
 .changeset/giant-cycles-end.md  | 5 +++++
 .changeset/mean-fans-cough.md   | 5 +++++
 .changeset/nice-pillows-poke.md | 5 +++++
 4 files changed, 20 insertions(+)
 create mode 100644 .changeset/flat-ducks-buy.md
 create mode 100644 .changeset/giant-cycles-end.md
 create mode 100644 .changeset/mean-fans-cough.md
 create mode 100644 .changeset/nice-pillows-poke.md

diff --git a/.changeset/flat-ducks-buy.md b/.changeset/flat-ducks-buy.md
new file mode 100644
index 0000000000..5c952faaf1
--- /dev/null
+++ b/.changeset/flat-ducks-buy.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-search-backend-node': patch
+---
+
+Fix highlighting for non-string fields on the `Lunr` search engine implementation.
diff --git a/.changeset/giant-cycles-end.md b/.changeset/giant-cycles-end.md
new file mode 100644
index 0000000000..6cd21fe54e
--- /dev/null
+++ b/.changeset/giant-cycles-end.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-stack-overflow-backend': patch
+---
+
+Migrate package to the new Frontend system, the new module is distributed with a `/alpha` subpath.
diff --git a/.changeset/mean-fans-cough.md b/.changeset/mean-fans-cough.md
new file mode 100644
index 0000000000..8f93cd361c
--- /dev/null
+++ b/.changeset/mean-fans-cough.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-search': patch
+---
+
+Add Stack Overflow type to the default alpha search page extension types filter.
diff --git a/.changeset/nice-pillows-poke.md b/.changeset/nice-pillows-poke.md
new file mode 100644
index 0000000000..1a3926f371
--- /dev/null
+++ b/.changeset/nice-pillows-poke.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-stack-overflow': patch
+---
+
+Migrate package to the new Backend system, the new module is distributed with a `/alpha` subpath.

From dad7d4de5b0b0c1a6307b57cfbc75585a4666fe1 Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Mon, 9 Oct 2023 08:17:02 +0200
Subject: [PATCH 08/21] chore: update yarn lock

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 yarn.lock | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/yarn.lock b/yarn.lock
index 1e2f6fdb5d..bc7aa10d86 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -9182,11 +9182,13 @@ __metadata:
   languageName: unknown
   linkType: soft
 
-"@backstage/plugin-stack-overflow-backend@workspace:plugins/stack-overflow-backend":
+"@backstage/plugin-stack-overflow-backend@workspace:^, @backstage/plugin-stack-overflow-backend@workspace:plugins/stack-overflow-backend":
   version: 0.0.0-use.local
   resolution: "@backstage/plugin-stack-overflow-backend@workspace:plugins/stack-overflow-backend"
   dependencies:
     "@backstage/backend-common": "workspace:^"
+    "@backstage/backend-plugin-api": "workspace:^"
+    "@backstage/backend-tasks": "workspace:^"
     "@backstage/backend-test-utils": "workspace:^"
     "@backstage/cli": "workspace:^"
     "@backstage/config": "workspace:^"
@@ -9209,6 +9211,7 @@ __metadata:
     "@backstage/core-components": "workspace:^"
     "@backstage/core-plugin-api": "workspace:^"
     "@backstage/dev-utils": "workspace:^"
+    "@backstage/frontend-plugin-api": "workspace:^"
     "@backstage/plugin-home-react": "workspace:^"
     "@backstage/plugin-search-common": "workspace:^"
     "@backstage/plugin-search-react": "workspace:^"
@@ -25502,6 +25505,7 @@ __metadata:
     "@backstage/plugin-search-backend-module-techdocs": "workspace:^"
     "@backstage/plugin-search-backend-node": "workspace:^"
     "@backstage/plugin-sonarqube-backend": "workspace:^"
+    "@backstage/plugin-stack-overflow-backend": "workspace:^"
     "@backstage/plugin-techdocs-backend": "workspace:^"
     "@backstage/plugin-todo-backend": "workspace:^"
   languageName: unknown

From 847841a89d766ce460039b7202e5c7ef23286e02 Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Mon, 9 Oct 2023 14:57:42 +0200
Subject: [PATCH 09/21] refactor(stack-overflow-backend): use official default
 request parameters

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 .changeset/giant-cycles-end.md                   |  2 ++
 plugins/stack-overflow-backend/README.md         |  2 +-
 .../StackOverflowQuestionsCollatorFactory.ts     | 16 +++++++++-------
 3 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/.changeset/giant-cycles-end.md b/.changeset/giant-cycles-end.md
index 6cd21fe54e..5d9f8149a8 100644
--- a/.changeset/giant-cycles-end.md
+++ b/.changeset/giant-cycles-end.md
@@ -3,3 +3,5 @@
 ---
 
 Migrate package to the new Frontend system, the new module is distributed with a `/alpha` subpath.
+
+The search collator `requestParams` option is optional now, so its defaults to `{ order: 'desc', sort: 'activity', site: 'stackoverflow' }` as done in the `Try It` section on the [official Stack Overflow API documentation](https://api.stackexchange.com/docs/questions).
diff --git a/plugins/stack-overflow-backend/README.md b/plugins/stack-overflow-backend/README.md
index 4575ab58c0..5de997faa6 100644
--- a/plugins/stack-overflow-backend/README.md
+++ b/plugins/stack-overflow-backend/README.md
@@ -45,7 +45,7 @@ This stack overflow backend plugin is primarily responsible for the following:
 
 Before you are able to start index stack overflow questions to search, you need to go through the [search getting started guide](https://backstage.io/docs/features/search/getting-started).
 
-When you have your `packages/backend/src/plugins/search.ts` file ready to make modifications, add the following code snippet to add the `StackOverflowQuestionsCollatorFactory`. Note that you can modify the `requestParams`.
+When you have your `packages/backend/src/plugins/search.ts` file ready to make modifications, add the following code snippet to add the `StackOverflowQuestionsCollatorFactory`. Note that you can optionally modify the `requestParams`, otherwise it will defaults to `{ order: 'desc', sort: 'activity', site: 'stackoverflow' }` as done in the `Try It` section on the [official Stack Overflow API documentation](https://api.stackexchange.com/docs/questions).
 
 > Note: if your `baseUrl` is set to the external stack overflow api `https://api.stackexchange.com/2.2`, you can find optional and required parameters under the official API documentation under [`Usage of /questions GET`](https://api.stackexchange.com/docs/questions)
 
diff --git a/plugins/stack-overflow-backend/src/search/StackOverflowQuestionsCollatorFactory.ts b/plugins/stack-overflow-backend/src/search/StackOverflowQuestionsCollatorFactory.ts
index cf1e56cb28..3c97937365 100644
--- a/plugins/stack-overflow-backend/src/search/StackOverflowQuestionsCollatorFactory.ts
+++ b/plugins/stack-overflow-backend/src/search/StackOverflowQuestionsCollatorFactory.ts
@@ -81,10 +81,13 @@ export class StackOverflowQuestionsCollatorFactory
     this.apiAccessToken = options.apiAccessToken;
     this.teamName = options.teamName;
     this.maxPage = options.maxPage;
+    // Sets the same default request parameters as the official API documentation
+    // See https://api.stackexchange.com/docs/questions
     this.requestParams = options.requestParams ?? {
-      tagged: ['backstage'],
+      order: 'desc',
+      sort: 'activity',
       site: 'stackoverflow',
-      pagesize: 100,
+      ...(options.requestParams ?? {}),
     };
     this.logger = options.logger.child({ documentType: this.type });
   }
@@ -102,10 +105,9 @@ export class StackOverflowQuestionsCollatorFactory
       config.getOptionalString('stackoverflow.baseUrl') ||
       'https://api.stackexchange.com/2.3';
     const maxPage = options.maxPage || 100;
-    const requestParams =
-      config.getOptional<StackOverflowQuestionsRequestParams>(
-        'stackoverflow.requestParams',
-      );
+    const requestParams = config
+      .getOptionalConfig('stackoverflow.requestParams')
+      ?.get<StackOverflowQuestionsRequestParams>();
     return new StackOverflowQuestionsCollatorFactory({
       baseUrl,
       maxPage,
@@ -184,7 +186,7 @@ export class StackOverflowQuestionsCollatorFactory
       );
 
       const data = await res.json();
-      for (const question of data.items) {
+      for (const question of data.items ?? []) {
         yield {
           title: question.title,
           location: question.link,

From 7b1296c57a4c5659c9c010b17ca3591869985b2b Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Mon, 9 Oct 2023 15:06:01 +0200
Subject: [PATCH 10/21] refactor(search): use string construction for non-text
 values

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 plugins/search-backend-node/src/engines/LunrSearchEngine.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/plugins/search-backend-node/src/engines/LunrSearchEngine.ts b/plugins/search-backend-node/src/engines/LunrSearchEngine.ts
index 02bd6f7fd7..27cfae3fdf 100644
--- a/plugins/search-backend-node/src/engines/LunrSearchEngine.ts
+++ b/plugins/search-backend-node/src/engines/LunrSearchEngine.ts
@@ -329,9 +329,9 @@ export function parseHighlightFields({
 
       const highlightedField = positions.reduce((content, pos) => {
         return (
-          `${content.toString().substring(0, pos[0])}${preTag}` +
-          `${content.toString().substring(pos[0], pos[0] + pos[1])}` +
-          `${postTag}${content.toString().substring(pos[0] + pos[1])}`
+          `${String(content).substring(0, pos[0])}${preTag}` +
+          `${String(content).substring(pos[0], pos[0] + pos[1])}` +
+          `${postTag}${String(content).substring(pos[0] + pos[1])}`
         );
       }, doc[field] ?? '');
 

From a8a4911713c4b2f4ac4da0031caef7b1def9594f Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Mon, 9 Oct 2023 15:49:21 +0200
Subject: [PATCH 11/21] refactor: do not install stack overflow plugin on
 example apps

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 packages/app-next/package.json     | 1 -
 packages/backend-next/package.json | 1 -
 packages/backend-next/src/index.ts | 1 -
 3 files changed, 3 deletions(-)

diff --git a/packages/app-next/package.json b/packages/app-next/package.json
index 71d888ee50..5437c66272 100644
--- a/packages/app-next/package.json
+++ b/packages/app-next/package.json
@@ -68,7 +68,6 @@
     "@backstage/plugin-search-react": "workspace:^",
     "@backstage/plugin-sentry": "workspace:^",
     "@backstage/plugin-shortcuts": "workspace:^",
-    "@backstage/plugin-stack-overflow": "workspace:^",
     "@backstage/plugin-stackstorm": "workspace:^",
     "@backstage/plugin-tech-insights": "workspace:^",
     "@backstage/plugin-tech-radar": "workspace:^",
diff --git a/packages/backend-next/package.json b/packages/backend-next/package.json
index 41864907e5..69aa81a9cb 100644
--- a/packages/backend-next/package.json
+++ b/packages/backend-next/package.json
@@ -56,7 +56,6 @@
     "@backstage/plugin-search-backend-module-techdocs": "workspace:^",
     "@backstage/plugin-search-backend-node": "workspace:^",
     "@backstage/plugin-sonarqube-backend": "workspace:^",
-    "@backstage/plugin-stack-overflow-backend": "workspace:^",
     "@backstage/plugin-techdocs-backend": "workspace:^",
     "@backstage/plugin-todo-backend": "workspace:^"
   },
diff --git a/packages/backend-next/src/index.ts b/packages/backend-next/src/index.ts
index 15f5ca9c38..bdfbc2c26b 100644
--- a/packages/backend-next/src/index.ts
+++ b/packages/backend-next/src/index.ts
@@ -46,7 +46,6 @@ backend.add(import('@backstage/plugin-search-backend-module-explore/alpha'));
 backend.add(import('@backstage/plugin-search-backend-module-techdocs/alpha'));
 backend.add(import('@backstage/plugin-search-backend/alpha'));
 backend.add(import('@backstage/plugin-techdocs-backend/alpha'));
-backend.add(import('@backstage/plugin-stack-overflow-backend/alpha'));
 backend.add(import('@backstage/plugin-todo-backend'));
 backend.add(import('@backstage/plugin-sonarqube-backend'));
 

From 27e22c6a21b33b6cc0162995053c5730fcad8a91 Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Mon, 9 Oct 2023 16:19:16 +0200
Subject: [PATCH 12/21] feat(stackoverflow-backend): extract search stack
 overflow module

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 .../.eslintrc.js                              |  1 +
 .../README.md                                 | 30 +++++++++
 .../alpha-api-report.md                       |  2 +-
 .../api-report.md                             | 56 ++++++++++++++++
 .../catalog-info.yaml                         | 10 +++
 .../config.d.ts                               | 51 +++++++++++++++
 .../package.json                              | 65 +++++++++++++++++++
 .../src/alpha.test.ts                         | 55 ++++++++++++++++
 .../src/alpha.ts                              |  6 +-
 ...ckOverflowQuestionsCollatorFactory.test.ts |  0
 .../StackOverflowQuestionsCollatorFactory.ts  |  0
 .../src/collators/index.ts                    | 22 +++++++
 .../src}/index.ts                             |  9 ++-
 plugins/stack-overflow-backend/api-report.md  | 59 ++++-------------
 plugins/stack-overflow-backend/package.json   | 24 ++-----
 plugins/stack-overflow-backend/src/index.ts   | 38 ++++++++++-
 yarn.lock                                     | 26 ++++++--
 17 files changed, 377 insertions(+), 77 deletions(-)
 create mode 100644 plugins/search-backend-module-stack-overflow/.eslintrc.js
 create mode 100644 plugins/search-backend-module-stack-overflow/README.md
 rename plugins/{stack-overflow-backend => search-backend-module-stack-overflow}/alpha-api-report.md (75%)
 create mode 100644 plugins/search-backend-module-stack-overflow/api-report.md
 create mode 100644 plugins/search-backend-module-stack-overflow/catalog-info.yaml
 create mode 100644 plugins/search-backend-module-stack-overflow/config.d.ts
 create mode 100644 plugins/search-backend-module-stack-overflow/package.json
 create mode 100644 plugins/search-backend-module-stack-overflow/src/alpha.test.ts
 rename plugins/{stack-overflow-backend => search-backend-module-stack-overflow}/src/alpha.ts (90%)
 rename plugins/{stack-overflow-backend/src/search => search-backend-module-stack-overflow/src/collators}/StackOverflowQuestionsCollatorFactory.test.ts (100%)
 rename plugins/{stack-overflow-backend/src/search => search-backend-module-stack-overflow/src/collators}/StackOverflowQuestionsCollatorFactory.ts (100%)
 create mode 100644 plugins/search-backend-module-stack-overflow/src/collators/index.ts
 rename plugins/{stack-overflow-backend/src/search => search-backend-module-stack-overflow/src}/index.ts (76%)

diff --git a/plugins/search-backend-module-stack-overflow/.eslintrc.js b/plugins/search-backend-module-stack-overflow/.eslintrc.js
new file mode 100644
index 0000000000..e2a53a6ad2
--- /dev/null
+++ b/plugins/search-backend-module-stack-overflow/.eslintrc.js
@@ -0,0 +1 @@
+module.exports = require('@backstage/cli/config/eslint-factory')(__dirname);
diff --git a/plugins/search-backend-module-stack-overflow/README.md b/plugins/search-backend-module-stack-overflow/README.md
new file mode 100644
index 0000000000..cba9617ea8
--- /dev/null
+++ b/plugins/search-backend-module-stack-overflow/README.md
@@ -0,0 +1,30 @@
+# search-backend-module-stack-overflow
+
+> DISCLAIMER: The new backend system is in alpha, and so are the search backend module support for the new backend system. We don't recommend you to migrate your backend installations to the new system yet. But if you want to experiment, you can find getting started guides below.
+
+This package exports a module that extends the search backend to also indexing the questions exposed by the [`Stack Overflow` API](https://api.stackexchange.com/docs/questions).
+
+## Installation
+
+Add the module package as a dependency:
+
+```bash
+# From your Backstage root directory
+yarn add --cwd packages/backend @backstage/plugin-search-backend-module-stack-overflow
+```
+
+Add the collator to your backend instance, along with the search plugin itself:
+
+```tsx
+// packages/backend/src/index.ts
+import { createBackend } from '@backstage/backend-defaults';
+
+const backend = createBackend();
+backend.add(import('@backstage/plugin-search-backend/alpha'));
+backend.add(
+  import('@backstage/plugin-search-backend-module-stack-overflow/alpha'),
+);
+backend.start();
+```
+
+You may also want to add configuration parameters to your app-config, for example for controlling the scheduled indexing interval. These parameters should be placed under the `stackoverflow` key. See [the config definition file](https://github.com/backstage/backstage/blob/master/plugins/search-backend-module-stack-overflow/config.d.ts) for more details.
diff --git a/plugins/stack-overflow-backend/alpha-api-report.md b/plugins/search-backend-module-stack-overflow/alpha-api-report.md
similarity index 75%
rename from plugins/stack-overflow-backend/alpha-api-report.md
rename to plugins/search-backend-module-stack-overflow/alpha-api-report.md
index 93d4cfe5e5..9d25cb0a7d 100644
--- a/plugins/stack-overflow-backend/alpha-api-report.md
+++ b/plugins/search-backend-module-stack-overflow/alpha-api-report.md
@@ -1,4 +1,4 @@
-## API Report File for "@backstage/plugin-stack-overflow-backend"
+## API Report File for "@backstage/plugin-search-backend-module-stack-overflow"
 
 > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
 
diff --git a/plugins/search-backend-module-stack-overflow/api-report.md b/plugins/search-backend-module-stack-overflow/api-report.md
new file mode 100644
index 0000000000..795b30cac2
--- /dev/null
+++ b/plugins/search-backend-module-stack-overflow/api-report.md
@@ -0,0 +1,56 @@
+## API Report File for "@backstage/plugin-search-backend-module-stack-overflow"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+/// <reference types="node" />
+
+import { Config } from '@backstage/config';
+import { DocumentCollatorFactory } from '@backstage/plugin-search-common';
+import { IndexableDocument } from '@backstage/plugin-search-common';
+import { Logger } from 'winston';
+import { Readable } from 'stream';
+
+// @public
+export interface StackOverflowDocument extends IndexableDocument {
+  // (undocumented)
+  answers: number;
+  // (undocumented)
+  tags: string[];
+}
+
+// @public
+export class StackOverflowQuestionsCollatorFactory
+  implements DocumentCollatorFactory
+{
+  // (undocumented)
+  execute(): AsyncGenerator<StackOverflowDocument>;
+  // (undocumented)
+  static fromConfig(
+    config: Config,
+    options: StackOverflowQuestionsCollatorFactoryOptions,
+  ): StackOverflowQuestionsCollatorFactory;
+  // (undocumented)
+  getCollator(): Promise<Readable>;
+  // (undocumented)
+  protected requestParams: StackOverflowQuestionsRequestParams;
+  // (undocumented)
+  readonly type: string;
+}
+
+// @public
+export type StackOverflowQuestionsCollatorFactoryOptions = {
+  baseUrl?: string;
+  maxPage?: number;
+  apiKey?: string;
+  apiAccessToken?: string;
+  teamName?: string;
+  requestParams?: StackOverflowQuestionsRequestParams;
+  logger: Logger;
+};
+
+// @public
+export type StackOverflowQuestionsRequestParams = {
+  [key: string]: string | string[] | number;
+};
+```
diff --git a/plugins/search-backend-module-stack-overflow/catalog-info.yaml b/plugins/search-backend-module-stack-overflow/catalog-info.yaml
new file mode 100644
index 0000000000..9075d1d591
--- /dev/null
+++ b/plugins/search-backend-module-stack-overflow/catalog-info.yaml
@@ -0,0 +1,10 @@
+apiVersion: backstage.io/v1alpha1
+kind: Component
+metadata:
+  name: backstage-plugin-search-backend-module-stack-overflow
+  title: '@backstage/plugin-search-backend-module-stack-overflow'
+  description: A module for the search backend that exports stack overflow modules
+spec:
+  lifecycle: experimental
+  type: backstage-backend-plugin-module
+  owner: discoverability-maintainers
diff --git a/plugins/search-backend-module-stack-overflow/config.d.ts b/plugins/search-backend-module-stack-overflow/config.d.ts
new file mode 100644
index 0000000000..d615179ed0
--- /dev/null
+++ b/plugins/search-backend-module-stack-overflow/config.d.ts
@@ -0,0 +1,51 @@
+/*
+ * Copyright 2023 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export interface Config {
+  /**
+   * Configuration options for the stack overflow plugin
+   */
+  stackoverflow?: {
+    /**
+     * The base url of the Stack Overflow API used for the plugin
+     */
+    baseUrl?: string;
+
+    /**
+     * The API key to authenticate to Stack Overflow API
+     * @visibility secret
+     */
+    apiKey?: string;
+
+    /**
+     * The name of the team for a Stack Overflow for Teams account
+     */
+    teamName?: string;
+
+    /**
+     * The API Access Token to authenticate to Stack Overflow API
+     * @visibility secret
+     */
+    apiAccessToken?: string;
+
+    /**
+     * Type representing the request parameters.
+     */
+    requestParams?: {
+      [key: string]: string | string[] | number;
+    };
+  };
+}
diff --git a/plugins/search-backend-module-stack-overflow/package.json b/plugins/search-backend-module-stack-overflow/package.json
new file mode 100644
index 0000000000..64ff4d32d3
--- /dev/null
+++ b/plugins/search-backend-module-stack-overflow/package.json
@@ -0,0 +1,65 @@
+{
+  "name": "@backstage/plugin-search-backend-module-stack-overflow",
+  "description": "A module for the search backend that exports stack overflow modules",
+  "version": "0.0.0",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./alpha": "./src/alpha.ts",
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "alpha": [
+        "src/alpha.ts"
+      ],
+      "package.json": [
+        "package.json"
+      ]
+    }
+  },
+  "backstage": {
+    "role": "backend-plugin-module"
+  },
+  "homepage": "https://backstage.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/backstage/backstage",
+    "directory": "plugins/search-backend-module-stack-overflow"
+  },
+  "scripts": {
+    "start": "backstage-cli package start",
+    "build": "backstage-cli package build",
+    "lint": "backstage-cli package lint",
+    "test": "backstage-cli package test",
+    "prepack": "backstage-cli package prepack",
+    "postpack": "backstage-cli package postpack",
+    "clean": "backstage-cli package clean"
+  },
+  "dependencies": {
+    "@backstage/backend-common": "workspace:^",
+    "@backstage/backend-plugin-api": "workspace:^",
+    "@backstage/backend-tasks": "workspace:^",
+    "@backstage/config": "workspace:^",
+    "@backstage/plugin-search-backend-node": "workspace:^",
+    "@backstage/plugin-search-common": "workspace:^",
+    "node-fetch": "^2.6.7",
+    "qs": "^6.9.4",
+    "winston": "^3.2.1"
+  },
+  "devDependencies": {
+    "@backstage/backend-test-utils": "workspace:^",
+    "@backstage/cli": "workspace:^",
+    "msw": "^1.2.1"
+  },
+  "files": [
+    "dist",
+    "config.d.ts"
+  ],
+  "configSchema": "config.d.ts"
+}
diff --git a/plugins/search-backend-module-stack-overflow/src/alpha.test.ts b/plugins/search-backend-module-stack-overflow/src/alpha.test.ts
new file mode 100644
index 0000000000..1dba1ab8c0
--- /dev/null
+++ b/plugins/search-backend-module-stack-overflow/src/alpha.test.ts
@@ -0,0 +1,55 @@
+/*
+ * Copyright 2023 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { mockServices, startTestBackend } from '@backstage/backend-test-utils';
+import { searchIndexRegistryExtensionPoint } from '@backstage/plugin-search-backend-node/alpha';
+import searchModuleStackOverflowCollator from './alpha';
+
+describe('searchModuleStackOverflowCollator', () => {
+  const schedule = {
+    frequency: { minutes: 10 },
+    timeout: { minutes: 15 },
+    initialDelay: { seconds: 3 },
+  };
+
+  it('should register the stack overflow collator to the search index registry extension point with factory and schedule', async () => {
+    const extensionPointMock = {
+      addCollator: jest.fn(),
+    };
+
+    await startTestBackend({
+      extensionPoints: [
+        [searchIndexRegistryExtensionPoint, extensionPointMock],
+      ],
+      features: [
+        searchModuleStackOverflowCollator(),
+        mockServices.rootConfig.factory({
+          data: {
+            stackoverflow: {
+              schedule,
+            },
+          },
+        }),
+      ],
+    });
+
+    expect(extensionPointMock.addCollator).toHaveBeenCalledTimes(1);
+    expect(extensionPointMock.addCollator).toHaveBeenCalledWith({
+      factory: expect.objectContaining({ type: 'stack-overflow' }),
+      schedule: expect.objectContaining({ run: expect.any(Function) }),
+    });
+  });
+});
diff --git a/plugins/stack-overflow-backend/src/alpha.ts b/plugins/search-backend-module-stack-overflow/src/alpha.ts
similarity index 90%
rename from plugins/stack-overflow-backend/src/alpha.ts
rename to plugins/search-backend-module-stack-overflow/src/alpha.ts
index 897cbd1ea2..85b686c9ed 100644
--- a/plugins/stack-overflow-backend/src/alpha.ts
+++ b/plugins/search-backend-module-stack-overflow/src/alpha.ts
@@ -21,7 +21,7 @@ import {
   createBackendModule,
 } from '@backstage/backend-plugin-api';
 import { searchIndexRegistryExtensionPoint } from '@backstage/plugin-search-backend-node/alpha';
-import { StackOverflowQuestionsCollatorFactory } from './search';
+import { StackOverflowQuestionsCollatorFactory } from './collators';
 
 /**
  * @packageDocumentation
@@ -52,9 +52,9 @@ export default createBackendModule({
           initialDelay: { seconds: 3 },
         };
 
-        const schedule = config.has('search.collators.stackoverflow.schedule')
+        const schedule = config.has('stackoverflow.schedule')
           ? readTaskScheduleDefinitionFromConfig(
-              config.getConfig('search.collators.stackoverflow.schedule'),
+              config.getConfig('stackoverflow.schedule'),
             )
           : defaultSchedule;
 
diff --git a/plugins/stack-overflow-backend/src/search/StackOverflowQuestionsCollatorFactory.test.ts b/plugins/search-backend-module-stack-overflow/src/collators/StackOverflowQuestionsCollatorFactory.test.ts
similarity index 100%
rename from plugins/stack-overflow-backend/src/search/StackOverflowQuestionsCollatorFactory.test.ts
rename to plugins/search-backend-module-stack-overflow/src/collators/StackOverflowQuestionsCollatorFactory.test.ts
diff --git a/plugins/stack-overflow-backend/src/search/StackOverflowQuestionsCollatorFactory.ts b/plugins/search-backend-module-stack-overflow/src/collators/StackOverflowQuestionsCollatorFactory.ts
similarity index 100%
rename from plugins/stack-overflow-backend/src/search/StackOverflowQuestionsCollatorFactory.ts
rename to plugins/search-backend-module-stack-overflow/src/collators/StackOverflowQuestionsCollatorFactory.ts
diff --git a/plugins/search-backend-module-stack-overflow/src/collators/index.ts b/plugins/search-backend-module-stack-overflow/src/collators/index.ts
new file mode 100644
index 0000000000..1170b52423
--- /dev/null
+++ b/plugins/search-backend-module-stack-overflow/src/collators/index.ts
@@ -0,0 +1,22 @@
+/*
+ * Copyright 2022 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export {
+  type StackOverflowDocument,
+  type StackOverflowQuestionsRequestParams,
+  type StackOverflowQuestionsCollatorFactoryOptions,
+  StackOverflowQuestionsCollatorFactory,
+} from './StackOverflowQuestionsCollatorFactory';
diff --git a/plugins/stack-overflow-backend/src/search/index.ts b/plugins/search-backend-module-stack-overflow/src/index.ts
similarity index 76%
rename from plugins/stack-overflow-backend/src/search/index.ts
rename to plugins/search-backend-module-stack-overflow/src/index.ts
index ed3e05cb28..eb1f7540de 100644
--- a/plugins/stack-overflow-backend/src/search/index.ts
+++ b/plugins/search-backend-module-stack-overflow/src/index.ts
@@ -1,5 +1,5 @@
 /*
- * Copyright 2022 The Backstage Authors
+ * Copyright 2023 The Backstage Authors
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,4 +14,9 @@
  * limitations under the License.
  */
 
-export * from './StackOverflowQuestionsCollatorFactory';
+/**
+ * @packageDocumentation
+ * A module for the search backend that exports Stack Overflow modules.
+ */
+
+export * from './collators';
diff --git a/plugins/stack-overflow-backend/api-report.md b/plugins/stack-overflow-backend/api-report.md
index e8fd710cf6..d113f7a0b6 100644
--- a/plugins/stack-overflow-backend/api-report.md
+++ b/plugins/stack-overflow-backend/api-report.md
@@ -3,54 +3,21 @@
 > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
 
 ```ts
-/// <reference types="node" />
+import { StackOverflowDocument as StackOverflowDocument_2 } from '@backstage/plugin-search-backend-module-stack-overflow';
+import { StackOverflowQuestionsCollatorFactory as StackOverflowQuestionsCollatorFactory_2 } from '@backstage/plugin-search-backend-module-stack-overflow';
+import { StackOverflowQuestionsRequestParams as StackOverflowQuestionsRequestParams_2 } from '@backstage/plugin-search-backend-module-stack-overflow';
 
-import { Config } from '@backstage/config';
-import { DocumentCollatorFactory } from '@backstage/plugin-search-common';
-import { IndexableDocument } from '@backstage/plugin-search-common';
-import { Logger } from 'winston';
-import { Readable } from 'stream';
+// @public @deprecated (undocumented)
+export type StackOverflowDocument = StackOverflowDocument_2;
 
-// @public
-export interface StackOverflowDocument extends IndexableDocument {
-  // (undocumented)
-  answers: number;
-  // (undocumented)
-  tags: string[];
-}
+// @public @deprecated (undocumented)
+export const StackOverflowQuestionsCollatorFactory: typeof StackOverflowQuestionsCollatorFactory_2;
 
-// @public
-export class StackOverflowQuestionsCollatorFactory
-  implements DocumentCollatorFactory
-{
-  // (undocumented)
-  execute(): AsyncGenerator<StackOverflowDocument>;
-  // (undocumented)
-  static fromConfig(
-    config: Config,
-    options: StackOverflowQuestionsCollatorFactoryOptions,
-  ): StackOverflowQuestionsCollatorFactory;
-  // (undocumented)
-  getCollator(): Promise<Readable>;
-  // (undocumented)
-  protected requestParams: StackOverflowQuestionsRequestParams;
-  // (undocumented)
-  readonly type: string;
-}
+// @public @deprecated (undocumented)
+export type StackOverflowQuestionsCollatorFactoryOptions =
+  StackOverflowQuestionsCollatorFactory_2;
 
-// @public
-export type StackOverflowQuestionsCollatorFactoryOptions = {
-  baseUrl?: string;
-  maxPage?: number;
-  apiKey?: string;
-  apiAccessToken?: string;
-  teamName?: string;
-  requestParams?: StackOverflowQuestionsRequestParams;
-  logger: Logger;
-};
-
-// @public
-export type StackOverflowQuestionsRequestParams = {
-  [key: string]: string | string[] | number;
-};
+// @public @deprecated (undocumented)
+export type StackOverflowQuestionsRequestParams =
+  StackOverflowQuestionsRequestParams_2;
 ```
diff --git a/plugins/stack-overflow-backend/package.json b/plugins/stack-overflow-backend/package.json
index 53857082d2..5235c33f1a 100644
--- a/plugins/stack-overflow-backend/package.json
+++ b/plugins/stack-overflow-backend/package.json
@@ -5,22 +5,9 @@
   "types": "src/index.ts",
   "license": "Apache-2.0",
   "publishConfig": {
-    "access": "public"
-  },
-  "exports": {
-    ".": "./src/index.ts",
-    "./alpha": "./src/alpha.ts",
-    "./package.json": "./package.json"
-  },
-  "typesVersions": {
-    "*": {
-      "alpha": [
-        "src/alpha.ts"
-      ],
-      "package.json": [
-        "package.json"
-      ]
-    }
+    "access": "public",
+    "main": "dist/index.cjs.js",
+    "types": "dist/index.d.ts"
   },
   "backstage": {
     "role": "backend-plugin"
@@ -46,10 +33,8 @@
   },
   "dependencies": {
     "@backstage/backend-common": "workspace:^",
-    "@backstage/backend-plugin-api": "workspace:^",
-    "@backstage/backend-tasks": "workspace:^",
     "@backstage/config": "workspace:^",
-    "@backstage/plugin-search-backend-node": "workspace:^",
+    "@backstage/plugin-search-backend-module-stack-overflow": "workspace:^",
     "@backstage/plugin-search-common": "workspace:^",
     "node-fetch": "^2.6.7",
     "qs": "^6.9.4",
@@ -58,6 +43,7 @@
   "devDependencies": {
     "@backstage/backend-test-utils": "workspace:^",
     "@backstage/cli": "workspace:^",
+    "@backstage/plugin-search-backend-node": "workspace:^",
     "msw": "^1.0.0"
   },
   "files": [
diff --git a/plugins/stack-overflow-backend/src/index.ts b/plugins/stack-overflow-backend/src/index.ts
index 6e461b8183..269748424b 100644
--- a/plugins/stack-overflow-backend/src/index.ts
+++ b/plugins/stack-overflow-backend/src/index.ts
@@ -20,4 +20,40 @@
  * @packageDocumentation
  */
 
-export * from './search';
+import {
+  StackOverflowDocument as _StackOverflowDocument,
+  StackOverflowQuestionsRequestParams as _StackOverflowQuestionsRequestParams,
+  StackOverflowQuestionsCollatorFactory as _StackOverflowQuestionsCollatorFactory,
+  StackOverflowQuestionsCollatorFactoryOptions as _StackOverflowQuestionsCollatorFactoryOptions,
+} from '@backstage/plugin-search-backend-module-stack-overflow';
+
+/**
+ * @public
+ * @deprecated
+ * Import from `@backstage/plugin-search-backend-module-stack-overflow` instead.
+ */
+export type StackOverflowDocument = _StackOverflowDocument;
+
+/**
+ * @public
+ * @deprecated
+ * Import from `@backstage/plugin-search-backend-module-stack-overflow` instead.
+ */
+export type StackOverflowQuestionsRequestParams =
+  _StackOverflowQuestionsRequestParams;
+
+/**
+ * @public
+ * @deprecated
+ * Import from `@backstage/plugin-search-backend-module-stack-overflow` instead.
+ */
+export type StackOverflowQuestionsCollatorFactoryOptions =
+  _StackOverflowQuestionsCollatorFactory;
+
+/**
+ * @public
+ * @deprecated
+ * Import from `@backstage/plugin-search-backend-module-stack-overflow` instead.
+ */
+export const StackOverflowQuestionsCollatorFactory =
+  _StackOverflowQuestionsCollatorFactory;
diff --git a/yarn.lock b/yarn.lock
index bc7aa10d86..6e2db68238 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -8847,6 +8847,25 @@ __metadata:
   languageName: unknown
   linkType: soft
 
+"@backstage/plugin-search-backend-module-stack-overflow@workspace:^, @backstage/plugin-search-backend-module-stack-overflow@workspace:plugins/search-backend-module-stack-overflow":
+  version: 0.0.0-use.local
+  resolution: "@backstage/plugin-search-backend-module-stack-overflow@workspace:plugins/search-backend-module-stack-overflow"
+  dependencies:
+    "@backstage/backend-common": "workspace:^"
+    "@backstage/backend-plugin-api": "workspace:^"
+    "@backstage/backend-tasks": "workspace:^"
+    "@backstage/backend-test-utils": "workspace:^"
+    "@backstage/cli": "workspace:^"
+    "@backstage/config": "workspace:^"
+    "@backstage/plugin-search-backend-node": "workspace:^"
+    "@backstage/plugin-search-common": "workspace:^"
+    msw: ^1.2.1
+    node-fetch: ^2.6.7
+    qs: ^6.9.4
+    winston: ^3.2.1
+  languageName: unknown
+  linkType: soft
+
 "@backstage/plugin-search-backend-module-techdocs@workspace:^, @backstage/plugin-search-backend-module-techdocs@workspace:plugins/search-backend-module-techdocs":
   version: 0.0.0-use.local
   resolution: "@backstage/plugin-search-backend-module-techdocs@workspace:plugins/search-backend-module-techdocs"
@@ -9182,16 +9201,15 @@ __metadata:
   languageName: unknown
   linkType: soft
 
-"@backstage/plugin-stack-overflow-backend@workspace:^, @backstage/plugin-stack-overflow-backend@workspace:plugins/stack-overflow-backend":
+"@backstage/plugin-stack-overflow-backend@workspace:plugins/stack-overflow-backend":
   version: 0.0.0-use.local
   resolution: "@backstage/plugin-stack-overflow-backend@workspace:plugins/stack-overflow-backend"
   dependencies:
     "@backstage/backend-common": "workspace:^"
-    "@backstage/backend-plugin-api": "workspace:^"
-    "@backstage/backend-tasks": "workspace:^"
     "@backstage/backend-test-utils": "workspace:^"
     "@backstage/cli": "workspace:^"
     "@backstage/config": "workspace:^"
+    "@backstage/plugin-search-backend-module-stack-overflow": "workspace:^"
     "@backstage/plugin-search-backend-node": "workspace:^"
     "@backstage/plugin-search-common": "workspace:^"
     msw: ^1.0.0
@@ -25317,7 +25335,6 @@ __metadata:
     "@backstage/plugin-search-react": "workspace:^"
     "@backstage/plugin-sentry": "workspace:^"
     "@backstage/plugin-shortcuts": "workspace:^"
-    "@backstage/plugin-stack-overflow": "workspace:^"
     "@backstage/plugin-stackstorm": "workspace:^"
     "@backstage/plugin-tech-insights": "workspace:^"
     "@backstage/plugin-tech-radar": "workspace:^"
@@ -25505,7 +25522,6 @@ __metadata:
     "@backstage/plugin-search-backend-module-techdocs": "workspace:^"
     "@backstage/plugin-search-backend-node": "workspace:^"
     "@backstage/plugin-sonarqube-backend": "workspace:^"
-    "@backstage/plugin-stack-overflow-backend": "workspace:^"
     "@backstage/plugin-techdocs-backend": "workspace:^"
     "@backstage/plugin-todo-backend": "workspace:^"
   languageName: unknown

From 20f8768427927c70311301568ce6e608da50c8fc Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Mon, 9 Oct 2023 16:31:36 +0200
Subject: [PATCH 13/21] refactor(search): do not add stack overflow types on
 the default page

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 plugins/search/src/alpha.tsx | 24 ------------------------
 1 file changed, 24 deletions(-)

diff --git a/plugins/search/src/alpha.tsx b/plugins/search/src/alpha.tsx
index 913a96d094..14e7067dfa 100644
--- a/plugins/search/src/alpha.tsx
+++ b/plugins/search/src/alpha.tsx
@@ -69,25 +69,6 @@ import { SearchType } from './components/SearchType';
 import { UrlUpdater } from './components/SearchPage/SearchPage';
 import { convertLegacyRouteRef } from '@backstage/core-plugin-api/alpha';
 
-/** @internal */
-const StackOverflowIcon = () => {
-  return (
-    <svg
-      viewBox="0 0 125 125"
-      width="25"
-      height="25"
-      fill="none"
-      xmlns="http://www.w3.org/2000/svg"
-    >
-      <path d="M84.021 75.825v31H11v-31H0v42h95v-42H84.021z" fill="#BCBBBB" />
-      <path
-        d="M21.057 96.825H74v-10H21.057v10zm1.058-23.915l51.428 10.794 2.117-10.265L24.23 62.645 22.115 72.91zm6.773-24.656l47.618 22.222 4.445-9.524L33.33 38.73l-4.444 9.524zm13.227-23.386l40.423 33.65 6.773-8.042-40.53-33.65-6.666 8.042zM68.147 0L59.68 6.243l31.323 42.222 8.465-6.243L68.147 0z"
-        fill="#F48024"
-      />
-    </svg>
-  );
-};
-
 /** @alpha */
 export const SearchApi = createApiExtension({
   factory: {
@@ -172,11 +153,6 @@ export const SearchPage = createPageExtension({
                         name: 'Architecture Decision Records',
                         icon: <DocsIcon />,
                       },
-                      {
-                        value: 'stack-overflow',
-                        name: 'Stack Overflow',
-                        icon: <StackOverflowIcon />,
-                      },
                     ]}
                   />
                   <Paper className={classes.filters}>

From 0ea51599408c1664640b11a595009daf3a61ca15 Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Mon, 9 Oct 2023 16:55:34 +0200
Subject: [PATCH 14/21] fix: docs link to stack overflow collator

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 docs/plugins/integrating-search-into-plugins.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/plugins/integrating-search-into-plugins.md b/docs/plugins/integrating-search-into-plugins.md
index 7fb8e40b20..f2692d4e91 100644
--- a/docs/plugins/integrating-search-into-plugins.md
+++ b/docs/plugins/integrating-search-into-plugins.md
@@ -22,7 +22,7 @@ Imagine you have a plugin that is responsible for storing FAQ snippets in a data
 
 The search platform provides an interface (`DocumentCollatorFactory` from package `@backstage/plugin-search-common`) that allows you to do exactly that. It works by registering each of your entries as a "document" that later represents one search result each.
 
-> You can always look at a working example, e.g. [StackOverflowQuestionsCollatorFactory](https://github.com/backstage/backstage/blob/master/plugins/stack-overflow-backend/src/search/StackOverflowQuestionsCollatorFactory.ts), if you are unsure or want to follow best practices.
+> You can always look at a working example, e.g. [StackOverflowQuestionsCollatorFactory](https://github.com/backstage/backstage/blob/master/plugins/search-backend-module-stack-overflow/src/collators/StackOverflowQuestionsCollatorFactory.ts), if you are unsure or want to follow best practices.
 
 #### 1. Install collator interface dependencies
 

From 46f0f1700eb803a416bd389cf9d713b2c41939c9 Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Mon, 9 Oct 2023 17:15:15 +0200
Subject: [PATCH 15/21] fix: update changeset files

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 .changeset/chilly-terms-behave.md | 5 +++++
 .changeset/giant-cycles-end.md    | 4 ++--
 .changeset/mean-fans-cough.md     | 5 -----
 .changeset/nice-pillows-poke.md   | 2 +-
 4 files changed, 8 insertions(+), 8 deletions(-)
 create mode 100644 .changeset/chilly-terms-behave.md
 delete mode 100644 .changeset/mean-fans-cough.md

diff --git a/.changeset/chilly-terms-behave.md b/.changeset/chilly-terms-behave.md
new file mode 100644
index 0000000000..47250364bf
--- /dev/null
+++ b/.changeset/chilly-terms-behave.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-search-backend-module-stack-overflow': patch
+---
+
+Extract a package for the Stack Overflow new backend system plugin.
diff --git a/.changeset/giant-cycles-end.md b/.changeset/giant-cycles-end.md
index 5d9f8149a8..6f637e05dd 100644
--- a/.changeset/giant-cycles-end.md
+++ b/.changeset/giant-cycles-end.md
@@ -2,6 +2,6 @@
 '@backstage/plugin-stack-overflow-backend': patch
 ---
 
-Migrate package to the new Frontend system, the new module is distributed with a `/alpha` subpath.
+Deprecate package in favor of the new `@backstage/plugin-search-backend-module-stack-overflow` module.
 
-The search collator `requestParams` option is optional now, so its defaults to `{ order: 'desc', sort: 'activity', site: 'stackoverflow' }` as done in the `Try It` section on the [official Stack Overflow API documentation](https://api.stackexchange.com/docs/questions).
+The search collator `requestParams` option is optional now, so its default value is `{ order: 'desc', sort: 'activity', site: 'stackoverflow' }` as defined in the `Try It` section on the [official Stack Overflow API documentation](https://api.stackexchange.com/docs/questions).
diff --git a/.changeset/mean-fans-cough.md b/.changeset/mean-fans-cough.md
deleted file mode 100644
index 8f93cd361c..0000000000
--- a/.changeset/mean-fans-cough.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-'@backstage/plugin-search': patch
----
-
-Add Stack Overflow type to the default alpha search page extension types filter.
diff --git a/.changeset/nice-pillows-poke.md b/.changeset/nice-pillows-poke.md
index 1a3926f371..64034c39d2 100644
--- a/.changeset/nice-pillows-poke.md
+++ b/.changeset/nice-pillows-poke.md
@@ -2,4 +2,4 @@
 '@backstage/plugin-stack-overflow': patch
 ---
 
-Migrate package to the new Backend system, the new module is distributed with a `/alpha` subpath.
+Migrate package to the new Frontend system, the new module is distributed with a `/alpha` subpath.

From 3c39045e2bcee481ae410e6115b8abbc449147dc Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Sat, 14 Oct 2023 12:08:57 +0200
Subject: [PATCH 16/21] refactor: rename stack overflow backend module

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 .changeset/chilly-terms-behave.md             |  2 +-
 .changeset/giant-cycles-end.md                |  2 +-
 .../integrating-search-into-plugins.md        |  2 +-
 .../.eslintrc.js                              |  0
 .../README.md                                 | 97 +++++++++++++++++++
 .../alpha-api-report.md                       |  2 +-
 .../api-report.md                             |  2 +-
 .../catalog-info.yaml                         |  4 +-
 .../config.d.ts                               |  0
 .../package.json                              |  2 +-
 .../src/alpha.test.ts                         |  0
 .../src/alpha.ts                              |  0
 ...ckOverflowQuestionsCollatorFactory.test.ts |  0
 .../StackOverflowQuestionsCollatorFactory.ts  |  0
 .../src/collators/index.ts                    |  0
 .../src/index.ts                              |  0
 .../README.md                                 | 30 ------
 plugins/stack-overflow-backend/api-report.md  |  6 +-
 plugins/stack-overflow-backend/package.json   |  2 +-
 plugins/stack-overflow-backend/src/index.ts   | 10 +-
 yarn.lock                                     |  6 +-
 21 files changed, 117 insertions(+), 50 deletions(-)
 rename plugins/{search-backend-module-stack-overflow => search-backend-module-stack-overflow-collator}/.eslintrc.js (100%)
 create mode 100644 plugins/search-backend-module-stack-overflow-collator/README.md
 rename plugins/{search-backend-module-stack-overflow => search-backend-module-stack-overflow-collator}/alpha-api-report.md (92%)
 rename plugins/{search-backend-module-stack-overflow => search-backend-module-stack-overflow-collator}/api-report.md (98%)
 rename plugins/{search-backend-module-stack-overflow => search-backend-module-stack-overflow-collator}/catalog-info.yaml (79%)
 rename plugins/{search-backend-module-stack-overflow => search-backend-module-stack-overflow-collator}/config.d.ts (100%)
 rename plugins/{search-backend-module-stack-overflow => search-backend-module-stack-overflow-collator}/package.json (99%)
 rename plugins/{search-backend-module-stack-overflow => search-backend-module-stack-overflow-collator}/src/alpha.test.ts (100%)
 rename plugins/{search-backend-module-stack-overflow => search-backend-module-stack-overflow-collator}/src/alpha.ts (100%)
 rename plugins/{search-backend-module-stack-overflow => search-backend-module-stack-overflow-collator}/src/collators/StackOverflowQuestionsCollatorFactory.test.ts (100%)
 rename plugins/{search-backend-module-stack-overflow => search-backend-module-stack-overflow-collator}/src/collators/StackOverflowQuestionsCollatorFactory.ts (100%)
 rename plugins/{search-backend-module-stack-overflow => search-backend-module-stack-overflow-collator}/src/collators/index.ts (100%)
 rename plugins/{search-backend-module-stack-overflow => search-backend-module-stack-overflow-collator}/src/index.ts (100%)
 delete mode 100644 plugins/search-backend-module-stack-overflow/README.md

diff --git a/.changeset/chilly-terms-behave.md b/.changeset/chilly-terms-behave.md
index 47250364bf..b514bc45c8 100644
--- a/.changeset/chilly-terms-behave.md
+++ b/.changeset/chilly-terms-behave.md
@@ -1,5 +1,5 @@
 ---
-'@backstage/plugin-search-backend-module-stack-overflow': patch
+'@backstage/plugin-search-backend-module-stack-overflow-collator': patch
 ---
 
 Extract a package for the Stack Overflow new backend system plugin.
diff --git a/.changeset/giant-cycles-end.md b/.changeset/giant-cycles-end.md
index 6f637e05dd..f69938ea25 100644
--- a/.changeset/giant-cycles-end.md
+++ b/.changeset/giant-cycles-end.md
@@ -2,6 +2,6 @@
 '@backstage/plugin-stack-overflow-backend': patch
 ---
 
-Deprecate package in favor of the new `@backstage/plugin-search-backend-module-stack-overflow` module.
+Deprecate package in favor of the new `@backstage/plugin-search-backend-module-stack-overflow-collator` module.
 
 The search collator `requestParams` option is optional now, so its default value is `{ order: 'desc', sort: 'activity', site: 'stackoverflow' }` as defined in the `Try It` section on the [official Stack Overflow API documentation](https://api.stackexchange.com/docs/questions).
diff --git a/docs/plugins/integrating-search-into-plugins.md b/docs/plugins/integrating-search-into-plugins.md
index f2692d4e91..28c8b410e3 100644
--- a/docs/plugins/integrating-search-into-plugins.md
+++ b/docs/plugins/integrating-search-into-plugins.md
@@ -22,7 +22,7 @@ Imagine you have a plugin that is responsible for storing FAQ snippets in a data
 
 The search platform provides an interface (`DocumentCollatorFactory` from package `@backstage/plugin-search-common`) that allows you to do exactly that. It works by registering each of your entries as a "document" that later represents one search result each.
 
-> You can always look at a working example, e.g. [StackOverflowQuestionsCollatorFactory](https://github.com/backstage/backstage/blob/master/plugins/search-backend-module-stack-overflow/src/collators/StackOverflowQuestionsCollatorFactory.ts), if you are unsure or want to follow best practices.
+> You can always look at a working example, e.g. [StackOverflowQuestionsCollatorFactory](https://github.com/backstage/backstage/blob/master/plugins/search-backend-module-stack-overflow-collator/src/collators/StackOverflowQuestionsCollatorFactory.ts), if you are unsure or want to follow best practices.
 
 #### 1. Install collator interface dependencies
 
diff --git a/plugins/search-backend-module-stack-overflow/.eslintrc.js b/plugins/search-backend-module-stack-overflow-collator/.eslintrc.js
similarity index 100%
rename from plugins/search-backend-module-stack-overflow/.eslintrc.js
rename to plugins/search-backend-module-stack-overflow-collator/.eslintrc.js
diff --git a/plugins/search-backend-module-stack-overflow-collator/README.md b/plugins/search-backend-module-stack-overflow-collator/README.md
new file mode 100644
index 0000000000..914746cbf9
--- /dev/null
+++ b/plugins/search-backend-module-stack-overflow-collator/README.md
@@ -0,0 +1,97 @@
+# Stack Overflow Search Backend Module
+
+A plugin that provides stack overflow specific functionality that can be used in different ways (e.g. for search) to compose your Backstage App.
+
+## Getting started
+
+Before we begin, make sure:
+
+- You have created your own standalone Backstage app using @backstage/create-app and not using a fork of the backstage repository. If you haven't setup Backstage already, start [here](https://backstage.io/docs/getting-started/).
+
+To use any of the functionality this plugin provides, you need to start by configuring your App with the following config:
+
+```yaml
+stackoverflow:
+  baseUrl: https://api.stackexchange.com/2.2 # alternative: your internal stack overflow instance
+```
+
+### Stack Overflow for Teams
+
+If you have a private Stack Overflow instance and/or a private Stack Overflow Team you will need to supply an API key or Personal Access Token. You can read more about how to set this up by going to [Stack Overflow's Help Page](https://stackoverflow.help/en/articles/4385859-stack-overflow-for-teams-api).
+
+The existing API key approach remains the default, to support the new v2.3 API and PAT authentication model you need to pass the team name and the new PAT into the existing apiAccessToken parameter to the new URL. See [15770](https://github.com/backstage/backstage/issues/15770) for more details.
+
+```yaml
+stackoverflow:
+  baseUrl: https://api.stackexchange.com/2.2 # alternative: your internal stack overflow instance
+  apiKey: $STACK_OVERFLOW_API_KEY
+  apiAccessToken: $STACK_OVERFLOW_API_ACCESS_TOKEN
+```
+
+```yaml
+stackoverflow:
+  baseUrl: https://api.stackoverflowteams.com/2.3 # alternative: your internal stack overflow instance
+  teamName: $STACK_OVERFLOW_TEAM_NAME
+  apiAccessToken: $STACK_OVERFLOW_API_ACCESS_TOKEN
+```
+
+## Areas of Responsibility
+
+This stack overflow backend plugin is primarily responsible for the following:
+
+- Provides a `StackOverflowQuestionsCollatorFactory`, which can be used in the search backend to index stack overflow questions to your Backstage Search.
+
+### Index Stack Overflow Questions to search
+
+Before you are able to start index stack overflow questions to search, you need to go through the [search getting started guide](https://backstage.io/docs/features/search/getting-started).
+
+When you have your `packages/backend/src/plugins/search.ts` file ready to make modifications, add the following code snippet to add the `StackOverflowQuestionsCollatorFactory`. Note that you can optionally modify the `requestParams`, otherwise it will defaults to `{ order: 'desc', sort: 'activity', site: 'stackoverflow' }` as done in the `Try It` section on the [official Stack Overflow API documentation](https://api.stackexchange.com/docs/questions).
+
+> Note: if your `baseUrl` is set to the external stack overflow api `https://api.stackexchange.com/2.2`, you can find optional and required parameters under the official API documentation under [`Usage of /questions GET`](https://api.stackexchange.com/docs/questions)
+
+```ts
+indexBuilder.addCollator({
+  schedule,
+  factory: StackOverflowQuestionsCollatorFactory.fromConfig(env.config, {
+    logger: env.logger,
+    requestParams: {
+      tagged: ['backstage'],
+      site: 'stackoverflow',
+      pagesize: 100,
+    },
+  }),
+});
+```
+
+## New Backend System
+
+> DISCLAIMER: The new backend system is in alpha, and so are the search backend module support for the new backend system. We don't recommend you to migrate your backend installations to the new system yet. But if you want to experiment, you can find getting started guides below.
+
+This package exports a module that extends the search backend to also indexing the questions exposed by the [`Stack Overflow` API](https://api.stackexchange.com/docs/questions).
+
+### Installation
+
+Add the module package as a dependency:
+
+```bash
+# From your Backstage root directory
+yarn add --cwd packages/backend @backstage/plugin-search-backend-module-stack-overflow-collator
+```
+
+Add the collator to your backend instance, along with the search plugin itself:
+
+```tsx
+// packages/backend/src/index.ts
+import { createBackend } from '@backstage/backend-defaults';
+
+const backend = createBackend();
+backend.add(import('@backstage/plugin-search-backend/alpha'));
+backend.add(
+  import(
+    '@backstage/plugin-search-backend-module-stack-overflow-collator/alpha'
+  ),
+);
+backend.start();
+```
+
+You may also want to add configuration parameters to your app-config, for example for controlling the scheduled indexing interval. These parameters should be placed under the `stackoverflow` key. See [the config definition file](https://github.com/backstage/backstage/blob/master/plugins/search-backend-module-stack-overflow/config.d.ts) for more details.
diff --git a/plugins/search-backend-module-stack-overflow/alpha-api-report.md b/plugins/search-backend-module-stack-overflow-collator/alpha-api-report.md
similarity index 92%
rename from plugins/search-backend-module-stack-overflow/alpha-api-report.md
rename to plugins/search-backend-module-stack-overflow-collator/alpha-api-report.md
index 9d25cb0a7d..a77d5e9598 100644
--- a/plugins/search-backend-module-stack-overflow/alpha-api-report.md
+++ b/plugins/search-backend-module-stack-overflow-collator/alpha-api-report.md
@@ -1,4 +1,4 @@
-## API Report File for "@backstage/plugin-search-backend-module-stack-overflow"
+## API Report File for "@backstage/plugin-search-backend-module-stack-overflow-collator"
 
 > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
 
diff --git a/plugins/search-backend-module-stack-overflow/api-report.md b/plugins/search-backend-module-stack-overflow-collator/api-report.md
similarity index 98%
rename from plugins/search-backend-module-stack-overflow/api-report.md
rename to plugins/search-backend-module-stack-overflow-collator/api-report.md
index 795b30cac2..996260c4aa 100644
--- a/plugins/search-backend-module-stack-overflow/api-report.md
+++ b/plugins/search-backend-module-stack-overflow-collator/api-report.md
@@ -1,4 +1,4 @@
-## API Report File for "@backstage/plugin-search-backend-module-stack-overflow"
+## API Report File for "@backstage/plugin-search-backend-module-stack-overflow-collator"
 
 > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
 
diff --git a/plugins/search-backend-module-stack-overflow/catalog-info.yaml b/plugins/search-backend-module-stack-overflow-collator/catalog-info.yaml
similarity index 79%
rename from plugins/search-backend-module-stack-overflow/catalog-info.yaml
rename to plugins/search-backend-module-stack-overflow-collator/catalog-info.yaml
index 9075d1d591..ed73bd0eca 100644
--- a/plugins/search-backend-module-stack-overflow/catalog-info.yaml
+++ b/plugins/search-backend-module-stack-overflow-collator/catalog-info.yaml
@@ -1,8 +1,8 @@
 apiVersion: backstage.io/v1alpha1
 kind: Component
 metadata:
-  name: backstage-plugin-search-backend-module-stack-overflow
-  title: '@backstage/plugin-search-backend-module-stack-overflow'
+  name: backstage-plugin-search-backend-module-stack-overflow-collator
+  title: '@backstage/plugin-search-backend-module-stack-overflow-collator'
   description: A module for the search backend that exports stack overflow modules
 spec:
   lifecycle: experimental
diff --git a/plugins/search-backend-module-stack-overflow/config.d.ts b/plugins/search-backend-module-stack-overflow-collator/config.d.ts
similarity index 100%
rename from plugins/search-backend-module-stack-overflow/config.d.ts
rename to plugins/search-backend-module-stack-overflow-collator/config.d.ts
diff --git a/plugins/search-backend-module-stack-overflow/package.json b/plugins/search-backend-module-stack-overflow-collator/package.json
similarity index 99%
rename from plugins/search-backend-module-stack-overflow/package.json
rename to plugins/search-backend-module-stack-overflow-collator/package.json
index 64ff4d32d3..6e0b484e40 100644
--- a/plugins/search-backend-module-stack-overflow/package.json
+++ b/plugins/search-backend-module-stack-overflow-collator/package.json
@@ -1,5 +1,5 @@
 {
-  "name": "@backstage/plugin-search-backend-module-stack-overflow",
+  "name": "@backstage/plugin-search-backend-module-stack-overflow-collator",
   "description": "A module for the search backend that exports stack overflow modules",
   "version": "0.0.0",
   "main": "src/index.ts",
diff --git a/plugins/search-backend-module-stack-overflow/src/alpha.test.ts b/plugins/search-backend-module-stack-overflow-collator/src/alpha.test.ts
similarity index 100%
rename from plugins/search-backend-module-stack-overflow/src/alpha.test.ts
rename to plugins/search-backend-module-stack-overflow-collator/src/alpha.test.ts
diff --git a/plugins/search-backend-module-stack-overflow/src/alpha.ts b/plugins/search-backend-module-stack-overflow-collator/src/alpha.ts
similarity index 100%
rename from plugins/search-backend-module-stack-overflow/src/alpha.ts
rename to plugins/search-backend-module-stack-overflow-collator/src/alpha.ts
diff --git a/plugins/search-backend-module-stack-overflow/src/collators/StackOverflowQuestionsCollatorFactory.test.ts b/plugins/search-backend-module-stack-overflow-collator/src/collators/StackOverflowQuestionsCollatorFactory.test.ts
similarity index 100%
rename from plugins/search-backend-module-stack-overflow/src/collators/StackOverflowQuestionsCollatorFactory.test.ts
rename to plugins/search-backend-module-stack-overflow-collator/src/collators/StackOverflowQuestionsCollatorFactory.test.ts
diff --git a/plugins/search-backend-module-stack-overflow/src/collators/StackOverflowQuestionsCollatorFactory.ts b/plugins/search-backend-module-stack-overflow-collator/src/collators/StackOverflowQuestionsCollatorFactory.ts
similarity index 100%
rename from plugins/search-backend-module-stack-overflow/src/collators/StackOverflowQuestionsCollatorFactory.ts
rename to plugins/search-backend-module-stack-overflow-collator/src/collators/StackOverflowQuestionsCollatorFactory.ts
diff --git a/plugins/search-backend-module-stack-overflow/src/collators/index.ts b/plugins/search-backend-module-stack-overflow-collator/src/collators/index.ts
similarity index 100%
rename from plugins/search-backend-module-stack-overflow/src/collators/index.ts
rename to plugins/search-backend-module-stack-overflow-collator/src/collators/index.ts
diff --git a/plugins/search-backend-module-stack-overflow/src/index.ts b/plugins/search-backend-module-stack-overflow-collator/src/index.ts
similarity index 100%
rename from plugins/search-backend-module-stack-overflow/src/index.ts
rename to plugins/search-backend-module-stack-overflow-collator/src/index.ts
diff --git a/plugins/search-backend-module-stack-overflow/README.md b/plugins/search-backend-module-stack-overflow/README.md
deleted file mode 100644
index cba9617ea8..0000000000
--- a/plugins/search-backend-module-stack-overflow/README.md
+++ /dev/null
@@ -1,30 +0,0 @@
-# search-backend-module-stack-overflow
-
-> DISCLAIMER: The new backend system is in alpha, and so are the search backend module support for the new backend system. We don't recommend you to migrate your backend installations to the new system yet. But if you want to experiment, you can find getting started guides below.
-
-This package exports a module that extends the search backend to also indexing the questions exposed by the [`Stack Overflow` API](https://api.stackexchange.com/docs/questions).
-
-## Installation
-
-Add the module package as a dependency:
-
-```bash
-# From your Backstage root directory
-yarn add --cwd packages/backend @backstage/plugin-search-backend-module-stack-overflow
-```
-
-Add the collator to your backend instance, along with the search plugin itself:
-
-```tsx
-// packages/backend/src/index.ts
-import { createBackend } from '@backstage/backend-defaults';
-
-const backend = createBackend();
-backend.add(import('@backstage/plugin-search-backend/alpha'));
-backend.add(
-  import('@backstage/plugin-search-backend-module-stack-overflow/alpha'),
-);
-backend.start();
-```
-
-You may also want to add configuration parameters to your app-config, for example for controlling the scheduled indexing interval. These parameters should be placed under the `stackoverflow` key. See [the config definition file](https://github.com/backstage/backstage/blob/master/plugins/search-backend-module-stack-overflow/config.d.ts) for more details.
diff --git a/plugins/stack-overflow-backend/api-report.md b/plugins/stack-overflow-backend/api-report.md
index d113f7a0b6..14dcdf2007 100644
--- a/plugins/stack-overflow-backend/api-report.md
+++ b/plugins/stack-overflow-backend/api-report.md
@@ -3,9 +3,9 @@
 > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
 
 ```ts
-import { StackOverflowDocument as StackOverflowDocument_2 } from '@backstage/plugin-search-backend-module-stack-overflow';
-import { StackOverflowQuestionsCollatorFactory as StackOverflowQuestionsCollatorFactory_2 } from '@backstage/plugin-search-backend-module-stack-overflow';
-import { StackOverflowQuestionsRequestParams as StackOverflowQuestionsRequestParams_2 } from '@backstage/plugin-search-backend-module-stack-overflow';
+import { StackOverflowDocument as StackOverflowDocument_2 } from '@backstage/plugin-search-backend-module-stack-overflow-collator';
+import { StackOverflowQuestionsCollatorFactory as StackOverflowQuestionsCollatorFactory_2 } from '@backstage/plugin-search-backend-module-stack-overflow-collator';
+import { StackOverflowQuestionsRequestParams as StackOverflowQuestionsRequestParams_2 } from '@backstage/plugin-search-backend-module-stack-overflow-collator';
 
 // @public @deprecated (undocumented)
 export type StackOverflowDocument = StackOverflowDocument_2;
diff --git a/plugins/stack-overflow-backend/package.json b/plugins/stack-overflow-backend/package.json
index 5235c33f1a..c7b65a5ef5 100644
--- a/plugins/stack-overflow-backend/package.json
+++ b/plugins/stack-overflow-backend/package.json
@@ -34,7 +34,7 @@
   "dependencies": {
     "@backstage/backend-common": "workspace:^",
     "@backstage/config": "workspace:^",
-    "@backstage/plugin-search-backend-module-stack-overflow": "workspace:^",
+    "@backstage/plugin-search-backend-module-stack-overflow-collator": "workspace:^",
     "@backstage/plugin-search-common": "workspace:^",
     "node-fetch": "^2.6.7",
     "qs": "^6.9.4",
diff --git a/plugins/stack-overflow-backend/src/index.ts b/plugins/stack-overflow-backend/src/index.ts
index 269748424b..e676de15e2 100644
--- a/plugins/stack-overflow-backend/src/index.ts
+++ b/plugins/stack-overflow-backend/src/index.ts
@@ -25,19 +25,19 @@ import {
   StackOverflowQuestionsRequestParams as _StackOverflowQuestionsRequestParams,
   StackOverflowQuestionsCollatorFactory as _StackOverflowQuestionsCollatorFactory,
   StackOverflowQuestionsCollatorFactoryOptions as _StackOverflowQuestionsCollatorFactoryOptions,
-} from '@backstage/plugin-search-backend-module-stack-overflow';
+} from '@backstage/plugin-search-backend-module-stack-overflow-collator';
 
 /**
  * @public
  * @deprecated
- * Import from `@backstage/plugin-search-backend-module-stack-overflow` instead.
+ * Import from `@backstage/plugin-search-backend-module-stack-overflow-collator` instead.
  */
 export type StackOverflowDocument = _StackOverflowDocument;
 
 /**
  * @public
  * @deprecated
- * Import from `@backstage/plugin-search-backend-module-stack-overflow` instead.
+ * Import from `@backstage/plugin-search-backend-module-stack-overflow-collator` instead.
  */
 export type StackOverflowQuestionsRequestParams =
   _StackOverflowQuestionsRequestParams;
@@ -45,7 +45,7 @@ export type StackOverflowQuestionsRequestParams =
 /**
  * @public
  * @deprecated
- * Import from `@backstage/plugin-search-backend-module-stack-overflow` instead.
+ * Import from `@backstage/plugin-search-backend-module-stack-overflow-collator` instead.
  */
 export type StackOverflowQuestionsCollatorFactoryOptions =
   _StackOverflowQuestionsCollatorFactory;
@@ -53,7 +53,7 @@ export type StackOverflowQuestionsCollatorFactoryOptions =
 /**
  * @public
  * @deprecated
- * Import from `@backstage/plugin-search-backend-module-stack-overflow` instead.
+ * Import from `@backstage/plugin-search-backend-module-stack-overflow-collator` instead.
  */
 export const StackOverflowQuestionsCollatorFactory =
   _StackOverflowQuestionsCollatorFactory;
diff --git a/yarn.lock b/yarn.lock
index 6e2db68238..1267ee2cb4 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -8847,9 +8847,9 @@ __metadata:
   languageName: unknown
   linkType: soft
 
-"@backstage/plugin-search-backend-module-stack-overflow@workspace:^, @backstage/plugin-search-backend-module-stack-overflow@workspace:plugins/search-backend-module-stack-overflow":
+"@backstage/plugin-search-backend-module-stack-overflow-collator@workspace:^, @backstage/plugin-search-backend-module-stack-overflow-collator@workspace:plugins/search-backend-module-stack-overflow-collator":
   version: 0.0.0-use.local
-  resolution: "@backstage/plugin-search-backend-module-stack-overflow@workspace:plugins/search-backend-module-stack-overflow"
+  resolution: "@backstage/plugin-search-backend-module-stack-overflow-collator@workspace:plugins/search-backend-module-stack-overflow-collator"
   dependencies:
     "@backstage/backend-common": "workspace:^"
     "@backstage/backend-plugin-api": "workspace:^"
@@ -9209,7 +9209,7 @@ __metadata:
     "@backstage/backend-test-utils": "workspace:^"
     "@backstage/cli": "workspace:^"
     "@backstage/config": "workspace:^"
-    "@backstage/plugin-search-backend-module-stack-overflow": "workspace:^"
+    "@backstage/plugin-search-backend-module-stack-overflow-collator": "workspace:^"
     "@backstage/plugin-search-backend-node": "workspace:^"
     "@backstage/plugin-search-common": "workspace:^"
     msw: ^1.0.0

From 95dc40505ac8bd01ec8c223a0cde04151b6c6e3d Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Sat, 14 Oct 2023 12:51:32 +0200
Subject: [PATCH 17/21] docs(stack-overflow): update api reports

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 plugins/stack-overflow/alpha-api-report.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/plugins/stack-overflow/alpha-api-report.md b/plugins/stack-overflow/alpha-api-report.md
index 84d7616759..8bf621b948 100644
--- a/plugins/stack-overflow/alpha-api-report.md
+++ b/plugins/stack-overflow/alpha-api-report.md
@@ -3,10 +3,12 @@
 > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
 
 ```ts
+import { AnyExternalRoutes } from '@backstage/core-plugin-api';
+import { AnyRoutes } from '@backstage/core-plugin-api';
 import { BackstagePlugin } from '@backstage/frontend-plugin-api';
 
 // @alpha (undocumented)
-const _default: BackstagePlugin;
+const _default: BackstagePlugin<AnyRoutes, AnyExternalRoutes>;
 export default _default;
 
 // (No @packageDocumentation comment for this package)

From 3b5bef78b297df7ce846b12f2ecac91e3a34036e Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Wed, 18 Oct 2023 10:51:04 +0200
Subject: [PATCH 18/21] chore(stack-overflow-backend): deprecate entire package

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 .../README.md                                 |  2 +-
 plugins/stack-overflow-backend/README.md      | 65 +------------------
 plugins/stack-overflow-backend/package.json   |  1 +
 plugins/stack-overflow-backend/src/index.ts   |  5 +-
 plugins/stack-overflow/alpha-api-report.md    |  4 +-
 5 files changed, 8 insertions(+), 69 deletions(-)

diff --git a/plugins/search-backend-module-stack-overflow-collator/README.md b/plugins/search-backend-module-stack-overflow-collator/README.md
index 914746cbf9..5fba2a3c79 100644
--- a/plugins/search-backend-module-stack-overflow-collator/README.md
+++ b/plugins/search-backend-module-stack-overflow-collator/README.md
@@ -94,4 +94,4 @@ backend.add(
 backend.start();
 ```
 
-You may also want to add configuration parameters to your app-config, for example for controlling the scheduled indexing interval. These parameters should be placed under the `stackoverflow` key. See [the config definition file](https://github.com/backstage/backstage/blob/master/plugins/search-backend-module-stack-overflow/config.d.ts) for more details.
+You may also want to add configuration parameters to your app-config, for example for controlling the scheduled indexing interval. These parameters should be placed under the `stackoverflow` key. See [the config definition file](https://github.com/backstage/backstage/blob/master/plugins/search-backend-module-stack-overflow-collator/config.d.ts) for more details.
diff --git a/plugins/stack-overflow-backend/README.md b/plugins/stack-overflow-backend/README.md
index 5de997faa6..8129d36e38 100644
--- a/plugins/stack-overflow-backend/README.md
+++ b/plugins/stack-overflow-backend/README.md
@@ -1,64 +1,3 @@
-# Stack Overflow
+# Stack Overflow Backend
 
-A plugin that provides stack overflow specific functionality that can be used in different ways (e.g. for search) to compose your Backstage App.
-
-## Getting started
-
-Before we begin, make sure:
-
-- You have created your own standalone Backstage app using @backstage/create-app and not using a fork of the backstage repository. If you haven't setup Backstage already, start [here](https://backstage.io/docs/getting-started/).
-
-To use any of the functionality this plugin provides, you need to start by configuring your App with the following config:
-
-```yaml
-stackoverflow:
-  baseUrl: https://api.stackexchange.com/2.2 # alternative: your internal stack overflow instance
-```
-
-### Stack Overflow for Teams
-
-If you have a private Stack Overflow instance and/or a private Stack Overflow Team you will need to supply an API key or Personal Access Token. You can read more about how to set this up by going to [Stack Overflow's Help Page](https://stackoverflow.help/en/articles/4385859-stack-overflow-for-teams-api).
-
-The existing API key approach remains the default, to support the new v2.3 API and PAT authentication model you need to pass the team name and the new PAT into the existing apiAccessToken parameter to the new URL. See [15770](https://github.com/backstage/backstage/issues/15770) for more details.
-
-```yaml
-stackoverflow:
-  baseUrl: https://api.stackexchange.com/2.2 # alternative: your internal stack overflow instance
-  apiKey: $STACK_OVERFLOW_API_KEY
-  apiAccessToken: $STACK_OVERFLOW_API_ACCESS_TOKEN
-```
-
-```yaml
-stackoverflow:
-  baseUrl: https://api.stackoverflowteams.com/2.3 # alternative: your internal stack overflow instance
-  teamName: $STACK_OVERFLOW_TEAM_NAME
-  apiAccessToken: $STACK_OVERFLOW_API_ACCESS_TOKEN
-```
-
-## Areas of Responsibility
-
-This stack overflow backend plugin is primarily responsible for the following:
-
-- Provides a `StackOverflowQuestionsCollatorFactory`, which can be used in the search backend to index stack overflow questions to your Backstage Search.
-
-### Index Stack Overflow Questions to search
-
-Before you are able to start index stack overflow questions to search, you need to go through the [search getting started guide](https://backstage.io/docs/features/search/getting-started).
-
-When you have your `packages/backend/src/plugins/search.ts` file ready to make modifications, add the following code snippet to add the `StackOverflowQuestionsCollatorFactory`. Note that you can optionally modify the `requestParams`, otherwise it will defaults to `{ order: 'desc', sort: 'activity', site: 'stackoverflow' }` as done in the `Try It` section on the [official Stack Overflow API documentation](https://api.stackexchange.com/docs/questions).
-
-> Note: if your `baseUrl` is set to the external stack overflow api `https://api.stackexchange.com/2.2`, you can find optional and required parameters under the official API documentation under [`Usage of /questions GET`](https://api.stackexchange.com/docs/questions)
-
-```ts
-indexBuilder.addCollator({
-  schedule,
-  factory: StackOverflowQuestionsCollatorFactory.fromConfig(env.config, {
-    logger: env.logger,
-    requestParams: {
-      tagged: ['backstage'],
-      site: 'stackoverflow',
-      pagesize: 100,
-    },
-  }),
-});
-```
+Deprecated, consider using `@backstage/plugin-search-backend-module-stack-overflow-collator` instead.
diff --git a/plugins/stack-overflow-backend/package.json b/plugins/stack-overflow-backend/package.json
index c7b65a5ef5..77ebd8c69e 100644
--- a/plugins/stack-overflow-backend/package.json
+++ b/plugins/stack-overflow-backend/package.json
@@ -1,5 +1,6 @@
 {
   "name": "@backstage/plugin-stack-overflow-backend",
+  "description": "Deprecated, consider using @backstage/plugin-search-backend-module-stack-overflow-collator instead",
   "version": "0.2.10",
   "main": "src/index.ts",
   "types": "src/index.ts",
diff --git a/plugins/stack-overflow-backend/src/index.ts b/plugins/stack-overflow-backend/src/index.ts
index e676de15e2..5ca1c8d283 100644
--- a/plugins/stack-overflow-backend/src/index.ts
+++ b/plugins/stack-overflow-backend/src/index.ts
@@ -15,9 +15,10 @@
  */
 
 /**
- * Stack Overflow backend plugin
- *
  * @packageDocumentation
+ * Stack Overflow backend plugin
+ * @deprecated
+ * Deprecated, consider using `@backstage/plugin-search-backend-module-stack-overflow-collator` instead.
  */
 
 import {
diff --git a/plugins/stack-overflow/alpha-api-report.md b/plugins/stack-overflow/alpha-api-report.md
index 8bf621b948..167f8e1736 100644
--- a/plugins/stack-overflow/alpha-api-report.md
+++ b/plugins/stack-overflow/alpha-api-report.md
@@ -3,12 +3,10 @@
 > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
 
 ```ts
-import { AnyExternalRoutes } from '@backstage/core-plugin-api';
-import { AnyRoutes } from '@backstage/core-plugin-api';
 import { BackstagePlugin } from '@backstage/frontend-plugin-api';
 
 // @alpha (undocumented)
-const _default: BackstagePlugin<AnyRoutes, AnyExternalRoutes>;
+const _default: BackstagePlugin<{}, {}>;
 export default _default;
 
 // (No @packageDocumentation comment for this package)

From d7a4e2225f7cadb61240cb44ff4ccef72f54f190 Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Thu, 19 Oct 2023 09:10:35 +0200
Subject: [PATCH 19/21] fix: changeset package version

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 .changeset/chilly-terms-behave.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.changeset/chilly-terms-behave.md b/.changeset/chilly-terms-behave.md
index b514bc45c8..8ee1ad8375 100644
--- a/.changeset/chilly-terms-behave.md
+++ b/.changeset/chilly-terms-behave.md
@@ -1,5 +1,5 @@
 ---
-'@backstage/plugin-search-backend-module-stack-overflow-collator': patch
+'@backstage/plugin-search-backend-module-stack-overflow-collator': minor
 ---
 
 Extract a package for the Stack Overflow new backend system plugin.

From 8a7f1ba2a511973bf1f82dc408e4526c88208b5f Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Thu, 19 Oct 2023 09:11:33 +0200
Subject: [PATCH 20/21] docs(stack-overflow): add note about missing hompage
 card extension

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 plugins/stack-overflow/src/alpha.tsx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/plugins/stack-overflow/src/alpha.tsx b/plugins/stack-overflow/src/alpha.tsx
index 18f0a0df1c..3708271ef1 100644
--- a/plugins/stack-overflow/src/alpha.tsx
+++ b/plugins/stack-overflow/src/alpha.tsx
@@ -44,5 +44,6 @@ const StackOverflowSearchResultListItem = createSearchResultListItemExtension({
 /** @alpha */
 export default createPlugin({
   id: 'stack-overflow',
+  // TODO: Migrate homepage cards when the declarative homepage plugin supports them
   extensions: [StackOverflowApi, StackOverflowSearchResultListItem],
 });

From e13e43a12509f72ae8322cbab1dc1f665c8c45b5 Mon Sep 17 00:00:00 2001
From: Camila Belo <camilaibs@gmail.com>
Date: Thu, 19 Oct 2023 09:28:38 +0200
Subject: [PATCH 21/21] refactor(stack-overflow-backend): remove alpha subpath

Signed-off-by: Camila Belo <camilaibs@gmail.com>
---
 .../README.md                                 |  4 +---
 .../alpha-api-report.md                       | 11 -----------
 .../api-report.md                             |  5 +++++
 .../package.json                              | 19 +++----------------
 .../src/index.ts                              |  1 +
 ...SearchStackOverflowCollatorModule.test.ts} |  6 +++---
 .../SearchStackOverflowCollatorModule.ts}     | 14 ++++----------
 .../src/module/index.ts                       | 17 +++++++++++++++++
 8 files changed, 34 insertions(+), 43 deletions(-)
 delete mode 100644 plugins/search-backend-module-stack-overflow-collator/alpha-api-report.md
 rename plugins/search-backend-module-stack-overflow-collator/src/{alpha.test.ts => module/SearchStackOverflowCollatorModule.test.ts} (90%)
 rename plugins/search-backend-module-stack-overflow-collator/src/{alpha.ts => module/SearchStackOverflowCollatorModule.ts} (88%)
 create mode 100644 plugins/search-backend-module-stack-overflow-collator/src/module/index.ts

diff --git a/plugins/search-backend-module-stack-overflow-collator/README.md b/plugins/search-backend-module-stack-overflow-collator/README.md
index 5fba2a3c79..7df3229eeb 100644
--- a/plugins/search-backend-module-stack-overflow-collator/README.md
+++ b/plugins/search-backend-module-stack-overflow-collator/README.md
@@ -87,9 +87,7 @@ import { createBackend } from '@backstage/backend-defaults';
 const backend = createBackend();
 backend.add(import('@backstage/plugin-search-backend/alpha'));
 backend.add(
-  import(
-    '@backstage/plugin-search-backend-module-stack-overflow-collator/alpha'
-  ),
+  import('@backstage/plugin-search-backend-module-stack-overflow-collator'),
 );
 backend.start();
 ```
diff --git a/plugins/search-backend-module-stack-overflow-collator/alpha-api-report.md b/plugins/search-backend-module-stack-overflow-collator/alpha-api-report.md
deleted file mode 100644
index a77d5e9598..0000000000
--- a/plugins/search-backend-module-stack-overflow-collator/alpha-api-report.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## API Report File for "@backstage/plugin-search-backend-module-stack-overflow-collator"
-
-> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
-
-```ts
-import { BackendFeature } from '@backstage/backend-plugin-api';
-
-// @alpha
-const _default: () => BackendFeature;
-export default _default;
-```
diff --git a/plugins/search-backend-module-stack-overflow-collator/api-report.md b/plugins/search-backend-module-stack-overflow-collator/api-report.md
index 996260c4aa..9243e786ac 100644
--- a/plugins/search-backend-module-stack-overflow-collator/api-report.md
+++ b/plugins/search-backend-module-stack-overflow-collator/api-report.md
@@ -5,12 +5,17 @@
 ```ts
 /// <reference types="node" />
 
+import { BackendFeature } from '@backstage/backend-plugin-api';
 import { Config } from '@backstage/config';
 import { DocumentCollatorFactory } from '@backstage/plugin-search-common';
 import { IndexableDocument } from '@backstage/plugin-search-common';
 import { Logger } from 'winston';
 import { Readable } from 'stream';
 
+// @public
+const searchStackOverflowCollatorModule: () => BackendFeature;
+export default searchStackOverflowCollatorModule;
+
 // @public
 export interface StackOverflowDocument extends IndexableDocument {
   // (undocumented)
diff --git a/plugins/search-backend-module-stack-overflow-collator/package.json b/plugins/search-backend-module-stack-overflow-collator/package.json
index 6e0b484e40..14e547de8e 100644
--- a/plugins/search-backend-module-stack-overflow-collator/package.json
+++ b/plugins/search-backend-module-stack-overflow-collator/package.json
@@ -6,22 +6,9 @@
   "types": "src/index.ts",
   "license": "Apache-2.0",
   "publishConfig": {
-    "access": "public"
-  },
-  "exports": {
-    ".": "./src/index.ts",
-    "./alpha": "./src/alpha.ts",
-    "./package.json": "./package.json"
-  },
-  "typesVersions": {
-    "*": {
-      "alpha": [
-        "src/alpha.ts"
-      ],
-      "package.json": [
-        "package.json"
-      ]
-    }
+    "access": "public",
+    "main": "dist/index.cjs.js",
+    "types": "dist/index.d.ts"
   },
   "backstage": {
     "role": "backend-plugin-module"
diff --git a/plugins/search-backend-module-stack-overflow-collator/src/index.ts b/plugins/search-backend-module-stack-overflow-collator/src/index.ts
index eb1f7540de..00d57a7b27 100644
--- a/plugins/search-backend-module-stack-overflow-collator/src/index.ts
+++ b/plugins/search-backend-module-stack-overflow-collator/src/index.ts
@@ -20,3 +20,4 @@
  */
 
 export * from './collators';
+export { searchStackOverflowCollatorModule as default } from './module';
diff --git a/plugins/search-backend-module-stack-overflow-collator/src/alpha.test.ts b/plugins/search-backend-module-stack-overflow-collator/src/module/SearchStackOverflowCollatorModule.test.ts
similarity index 90%
rename from plugins/search-backend-module-stack-overflow-collator/src/alpha.test.ts
rename to plugins/search-backend-module-stack-overflow-collator/src/module/SearchStackOverflowCollatorModule.test.ts
index 1dba1ab8c0..a785ead6eb 100644
--- a/plugins/search-backend-module-stack-overflow-collator/src/alpha.test.ts
+++ b/plugins/search-backend-module-stack-overflow-collator/src/module/SearchStackOverflowCollatorModule.test.ts
@@ -16,9 +16,9 @@
 
 import { mockServices, startTestBackend } from '@backstage/backend-test-utils';
 import { searchIndexRegistryExtensionPoint } from '@backstage/plugin-search-backend-node/alpha';
-import searchModuleStackOverflowCollator from './alpha';
+import { searchStackOverflowCollatorModule } from './SearchStackOverflowCollatorModule';
 
-describe('searchModuleStackOverflowCollator', () => {
+describe('searchStackOverflowCollatorModule', () => {
   const schedule = {
     frequency: { minutes: 10 },
     timeout: { minutes: 15 },
@@ -35,7 +35,7 @@ describe('searchModuleStackOverflowCollator', () => {
         [searchIndexRegistryExtensionPoint, extensionPointMock],
       ],
       features: [
-        searchModuleStackOverflowCollator(),
+        searchStackOverflowCollatorModule(),
         mockServices.rootConfig.factory({
           data: {
             stackoverflow: {
diff --git a/plugins/search-backend-module-stack-overflow-collator/src/alpha.ts b/plugins/search-backend-module-stack-overflow-collator/src/module/SearchStackOverflowCollatorModule.ts
similarity index 88%
rename from plugins/search-backend-module-stack-overflow-collator/src/alpha.ts
rename to plugins/search-backend-module-stack-overflow-collator/src/module/SearchStackOverflowCollatorModule.ts
index 85b686c9ed..3ef3d72c32 100644
--- a/plugins/search-backend-module-stack-overflow-collator/src/alpha.ts
+++ b/plugins/search-backend-module-stack-overflow-collator/src/module/SearchStackOverflowCollatorModule.ts
@@ -21,20 +21,14 @@ import {
   createBackendModule,
 } from '@backstage/backend-plugin-api';
 import { searchIndexRegistryExtensionPoint } from '@backstage/plugin-search-backend-node/alpha';
-import { StackOverflowQuestionsCollatorFactory } from './collators';
-
-/**
- * @packageDocumentation
- * A module for the search backend that exports Stack Overflow modules.
- */
+import { StackOverflowQuestionsCollatorFactory } from '../collators';
 
 /**
+ * @public
  * Search backend module for the Stack Overflow index.
- *
- * @alpha
  */
-export default createBackendModule({
-  moduleId: 'stackoverflowCollator',
+export const searchStackOverflowCollatorModule = createBackendModule({
+  moduleId: 'stackOverflowCollator',
   pluginId: 'search',
   register(env) {
     env.registerInit({
diff --git a/plugins/search-backend-module-stack-overflow-collator/src/module/index.ts b/plugins/search-backend-module-stack-overflow-collator/src/module/index.ts
new file mode 100644
index 0000000000..ab424398e0
--- /dev/null
+++ b/plugins/search-backend-module-stack-overflow-collator/src/module/index.ts
@@ -0,0 +1,17 @@
+/*
+ * Copyright 2023 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export { searchStackOverflowCollatorModule } from './SearchStackOverflowCollatorModule';