diff --git a/.changeset/curly-points-hide.md b/.changeset/curly-points-hide.md
new file mode 100644
index 0000000000..ba513e5915
--- /dev/null
+++ b/.changeset/curly-points-hide.md
@@ -0,0 +1,6 @@
+---
+'@backstage/plugin-tech-insights-backend': patch
+'@backstage/plugin-tech-insights-backend-module-jsonfc': patch
+---
+
+Update README docs to use correct function/parameter names
diff --git a/plugins/tech-insights-backend-module-jsonfc/README.md b/plugins/tech-insights-backend-module-jsonfc/README.md
index 48c1e69919..c0f992ffc7 100644
--- a/plugins/tech-insights-backend-module-jsonfc/README.md
+++ b/plugins/tech-insights-backend-module-jsonfc/README.md
@@ -24,7 +24,7 @@ and modify the `techInsights.ts` file to contain a reference to the FactCheckers
 +   logger,
 +}),
 
- const builder = new DefaultTechInsightsBuilder({
+ const builder = buildTechInsightsContext({
    logger,
    config,
    database,
@@ -59,7 +59,7 @@ export const exampleCheck: TechInsightJsonRuleCheck = {
   name: 'demodatacheck', // A human readable name of this check to be displayed in the UI
   type: JSON_RULE_ENGINE_CHECK_TYPE, // Type identifier of the check. Used to run logic against, determine persistence option to use and render correct components on the UI
   description: 'A fact check for demoing purposes', // A description to be displayed in the UI
-  factRefs: ['demo-poc.factretriever'], // References to fact containers that this check uses. See documentation on FactRetrievers for more information on these
+  factIds: ['documentation-number-factretriever'], // References to fact ids that this check uses. See documentation on FactRetrievers for more information on these
   rule: {
     // The actual rule
     conditions: {
diff --git a/plugins/tech-insights-backend/README.md b/plugins/tech-insights-backend/README.md
index e2cc1c0252..764ad860b8 100644
--- a/plugins/tech-insights-backend/README.md
+++ b/plugins/tech-insights-backend/README.md
@@ -22,7 +22,7 @@ do this by creating a file called `packages/backend/src/plugins/techInsights.ts`
 ```ts
 import {
   createRouter,
-  DefaultTechInsightsBuilder,
+  buildTechInsightsContext,
 } from '@backstage/plugin-tech-insights-backend';
 import { Router } from 'express';
 import { PluginEnvironment } from '../types';
@@ -33,7 +33,7 @@ export default async function createPlugin({
   discovery,
   database,
 }: PluginEnvironment): Promise<Router> {
-  const builder = new DefaultTechInsightsBuilder({
+  const builder = buildTechInsightsContext({
     logger,
     config,
     database,