From fcd4cf34b38fb15c1bdc227e5d851586ffa8084f Mon Sep 17 00:00:00 2001 From: Ruben Dinis Date: Mon, 2 Feb 2026 17:21:07 +0000 Subject: [PATCH 01/10] Simplify data point page to link to talent.app/~/data --- docs/protocol-concepts/data-point.mdx | 36 +-------------------------- 1 file changed, 1 insertion(+), 35 deletions(-) diff --git a/docs/protocol-concepts/data-point.mdx b/docs/protocol-concepts/data-point.mdx index d4d6e9f..29a8a3e 100644 --- a/docs/protocol-concepts/data-point.mdx +++ b/docs/protocol-concepts/data-point.mdx @@ -4,38 +4,4 @@ sidebar_position: 4 # Data Point -A Data Point is specific type of reputation data about a given user. - -## Key Attributes: - -- A Data Point provides a verified fact about a user's reputation at a given point in time. -- A Data Point is always associated with a [Data Issuer](/docs/protocol-concepts/data-issuer). -- A Data Issuer can have multiple Data Points, but a Data Point only has one Data Issuer. -- A Data Point only contains objective and verifiable data. -- A Data Point doesn't store any scoring information; they can be use in multiple scoring systems. -- Example: - - Data Issuer: `GitHub` - - Data Point: `Stars` - - Value: `[number of stars]` - -## **Variable** and I**mmutable** Data Points: - -- Immutable data points are simpler versions of variable data points. -- **Variable Data Points** contain a value that can change over time. -- Example: GitHub Stars, ETH Balance on Base -- **Immutable Data Points** are only set once, and never recalculated again. -- Example: Base Learn, KYC, First Transaction on Base - -## Categories of Data Points: - -- **Metrics**: Ongoing measurable activities (e.g., GitHub contributions, transactions) -- **Achievements**: One-time accomplishments and permanent credentials (e.g., a hackathon win) -- **Affiliations**: Memberships and group affiliations that can be lost or revoked (e.g., job or a DAO) -- **Accounts**: Social profiles and other verifications (e.g., twitter, farcaster, github) - -## Scoring Tags - -- We use a **tag-based system** that determines how data points are used in [Scoring Systems](/docs/protocol-concepts/scoring-systems): - - Initial tags: `human`, `builder`, `creator` - - Data points can have multiple tags - - Scoring systems use tags to determine which data points to include +Explore data indexed by Talent at [https://talent.app/~/data](https://talent.app/~/data). From 4af52cfef67dde0db2c7fffc42a8f5ac2aa78238 Mon Sep 17 00:00:00 2001 From: Ruben Dinis Date: Mon, 2 Feb 2026 17:27:17 +0000 Subject: [PATCH 02/10] Update data-points index page to link to talent.app/~/data and restore protocol-concepts/data-point --- docs/data-points/index.mdx | 7 ++++++ docs/protocol-concepts/data-point.mdx | 36 ++++++++++++++++++++++++++- 2 files changed, 42 insertions(+), 1 deletion(-) create mode 100644 docs/data-points/index.mdx diff --git a/docs/data-points/index.mdx b/docs/data-points/index.mdx new file mode 100644 index 0000000..2ce0a27 --- /dev/null +++ b/docs/data-points/index.mdx @@ -0,0 +1,7 @@ +--- +sidebar_position: 1 +--- + +# Data Points + +Explore data indexed by Talent at [https://talent.app/~/data](https://talent.app/~/data). diff --git a/docs/protocol-concepts/data-point.mdx b/docs/protocol-concepts/data-point.mdx index 29a8a3e..e1838e2 100644 --- a/docs/protocol-concepts/data-point.mdx +++ b/docs/protocol-concepts/data-point.mdx @@ -4,4 +4,38 @@ sidebar_position: 4 # Data Point -Explore data indexed by Talent at [https://talent.app/~/data](https://talent.app/~/data). +A Data Point is specific type of reputation data about a given user. + +## Key Attributes: + +- A Data Point provides a verified fact about a user's reputation at a given point in time. +- A Data Point is always associated with a [Data Issuer](/docs/protocol-concepts/data-issuer). +- A Data Issuer can have multiple Data Points, but a Data Point only has one Data Issuer. +- A Data Point only contains objective and verifiable data. +- A Data Point doesn't store any scoring information; they can be use in multiple scoring systems. +- Example: + - Data Issuer: `GitHub` + - Data Point: `Stars` + - Value: `[number of stars]` + +## **Variable** and **Immutable** Data Points: + +- Immutable data points are simpler versions of variable data points. +- **Variable Data Points** contain a value that can change over time. +- Example: GitHub Stars, ETH Balance on Base +- **Immutable Data Points** are only set once, and never recalculated again. +- Example: Base Learn, KYC, First Transaction on Base + +## Categories of Data Points: + +- **Metrics**: Ongoing measurable activities (e.g., GitHub contributions, transactions) +- **Achievements**: One-time accomplishments and permanent credentials (e.g., a hackathon win) +- **Affiliations**: Memberships and group affiliations that can be lost or revoked (e.g., job or a DAO) +- **Accounts**: Social profiles and other verifications (e.g., twitter, farcaster, github) + +## Scoring Tags + +- We use a **tag-based system** that determines how data points are used in [Scoring Systems](/docs/protocol-concepts/scoring-systems): + - Initial tags: `human`, `builder`, `creator` + - Data points can have multiple tags + - Scoring systems use tags to determine which data points to include From dbc16ec5a3853ca67cc4bf7529a062c066a79da1 Mon Sep 17 00:00:00 2001 From: Ruben Dinis Date: Mon, 2 Feb 2026 18:38:05 +0000 Subject: [PATCH 03/10] Change Data Points from collapsible category to page link --- docs/data-points/_category_.json | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/data-points/_category_.json b/docs/data-points/_category_.json index a0a0135..ff4459f 100644 --- a/docs/data-points/_category_.json +++ b/docs/data-points/_category_.json @@ -2,9 +2,7 @@ "label": "Data Points", "position": 3, "link": { - "type": "generated-index", - "title": "Data Points", - "slug": "/data-points", - "description": "Data Points that Talent Protocol keeps track of." + "type": "doc", + "id": "data-points/index" } } From db6afce9887bd0001d6c7769e8c81fe6cf14cdc8 Mon Sep 17 00:00:00 2001 From: Ruben Dinis Date: Mon, 2 Feb 2026 18:39:41 +0000 Subject: [PATCH 04/10] Remove sub-items from Data Points category --- docs/data-points/_category_.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/data-points/_category_.json b/docs/data-points/_category_.json index ff4459f..829acb4 100644 --- a/docs/data-points/_category_.json +++ b/docs/data-points/_category_.json @@ -4,5 +4,6 @@ "link": { "type": "doc", "id": "data-points/index" - } + }, + "items": [] } From 22f90ba9692414ac8500d6b1e469aea113a652b9 Mon Sep 17 00:00:00 2001 From: Ruben Dinis Date: Mon, 2 Feb 2026 18:41:32 +0000 Subject: [PATCH 05/10] Filter out sub-items from Data Points category in sidebar --- docusaurus.config.js | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docusaurus.config.js b/docusaurus.config.js index 19acf50..f4bd559 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -14,6 +14,12 @@ import webpack from "webpack"; const replaceAutogeneratedWithSidebarFile = (sidebarItems) => { return sidebarItems.map((item) => { if (Array.isArray(item.items)) { + // Remove sub-items from data-points category + if (item.label === "Data Points" || item.id === "data-points") { + item.items = []; + return item; + } + if (item.customProps?.autogenerate === false) { const fs = require("fs"); const path = require("path"); From d8e5735dcef7f55f2b770956a239a5347de24fdc Mon Sep 17 00:00:00 2001 From: Ruben Dinis Date: Mon, 2 Feb 2026 18:42:22 +0000 Subject: [PATCH 06/10] Remove items property from category file (not allowed with doc link) --- docs/data-points/_category_.json | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/data-points/_category_.json b/docs/data-points/_category_.json index 829acb4..ff4459f 100644 --- a/docs/data-points/_category_.json +++ b/docs/data-points/_category_.json @@ -4,6 +4,5 @@ "link": { "type": "doc", "id": "data-points/index" - }, - "items": [] + } } From 59426356b66e6eb799e02003235658995a508f0b Mon Sep 17 00:00:00 2001 From: Ruben Dinis Date: Mon, 2 Feb 2026 18:44:50 +0000 Subject: [PATCH 07/10] Remove Data Points category, make it a regular page link --- docs/data-points/_category_.json | 8 -------- docusaurus.config.js | 6 ------ 2 files changed, 14 deletions(-) delete mode 100644 docs/data-points/_category_.json diff --git a/docs/data-points/_category_.json b/docs/data-points/_category_.json deleted file mode 100644 index ff4459f..0000000 --- a/docs/data-points/_category_.json +++ /dev/null @@ -1,8 +0,0 @@ -{ - "label": "Data Points", - "position": 3, - "link": { - "type": "doc", - "id": "data-points/index" - } -} diff --git a/docusaurus.config.js b/docusaurus.config.js index f4bd559..19acf50 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -14,12 +14,6 @@ import webpack from "webpack"; const replaceAutogeneratedWithSidebarFile = (sidebarItems) => { return sidebarItems.map((item) => { if (Array.isArray(item.items)) { - // Remove sub-items from data-points category - if (item.label === "Data Points" || item.id === "data-points") { - item.items = []; - return item; - } - if (item.customProps?.autogenerate === false) { const fs = require("fs"); const path = require("path"); From fdbcb43a00e90ee34f864e6f093d96096335d913 Mon Sep 17 00:00:00 2001 From: Ruben Dinis Date: Mon, 2 Feb 2026 18:48:32 +0000 Subject: [PATCH 08/10] Fix data points plugin to preserve index.mdx and fix broken links --- .../talent-api/api-reference/index.mdx | 2 +- docs/developers/talent-api/index.mdx | 2 +- .../docusaurus-plugin-gen-data-points/index.js | 16 +++++++++++++++- 3 files changed, 17 insertions(+), 3 deletions(-) diff --git a/docs/developers/talent-api/api-reference/index.mdx b/docs/developers/talent-api/api-reference/index.mdx index f414e0e..983bea1 100644 --- a/docs/developers/talent-api/api-reference/index.mdx +++ b/docs/developers/talent-api/api-reference/index.mdx @@ -25,7 +25,7 @@ Base URL: `https://api.talentprotocol.com/` - [**Score Data**](/docs/developers/talent-api/api-reference/get-a-specific-score-using-wallet-scorer-slug-talent-id-or-account-identifier): `/score` - Get Builder Score and other scoring information - [**Farcaster Scores**](/docs/developers/talent-api/api-reference/get-the-score-of-farcaster-accounts): `/farcaster/scores` - Get the Builder Score of Farcaster users - [**Credentials Data**](/docs/developers/talent-api/api-reference/get-the-score-and-the-credentials-using-wallet-scorer-slug-talent-id-or-account-identifier): `/credentials` - Get the points each data point contributed to the Builder Score -- [**Data Points**](/docs/data-points): `/data_points` - Get the data points providing a list of slugs and for a Talent profile +- [**Data Points**](https://talent.app/~/data): `/data_points` - Get the data points providing a list of slugs and for a Talent profile - [**Account Data**](/docs/developers/talent-api/api-reference/get-account-using-wallet-talent-id-or-account-identifier): `/accounts` - Get connected accounts information - [**Social Data**](/docs/developers/talent-api/api-reference/get-socials-using-wallet-talent-id-or-account-identifier): `/socials` - Get connected social media information - [**Projects**](/docs/developers/talent-api/api-reference/get-projects-created-by-the-talent-profile): `/projects` - Get projects created by ID or account identifier diff --git a/docs/developers/talent-api/index.mdx b/docs/developers/talent-api/index.mdx index d6271e2..da8372f 100644 --- a/docs/developers/talent-api/index.mdx +++ b/docs/developers/talent-api/index.mdx @@ -10,5 +10,5 @@ Integrate the Builder Score to help great builders stand out in your app. Access verified reputation data to identify and engage with real builders in your app. -Our API provides Builder Scores, identity verification, and hundreds of other [data points](/docs/data-points) +Our API provides Builder Scores, identity verification, and hundreds of other [data points](https://talent.app/~/data) through simple, reliable endpoints. diff --git a/plugins/docusaurus-plugin-gen-data-points/index.js b/plugins/docusaurus-plugin-gen-data-points/index.js index 25cade8..286891b 100644 --- a/plugins/docusaurus-plugin-gen-data-points/index.js +++ b/plugins/docusaurus-plugin-gen-data-points/index.js @@ -68,6 +68,19 @@ ${dataIssuer.description || `${dataIssuer.name} data points`} console.log(`Generated ${filePath}`); } + // Generate index.mdx file + const indexFilePath = path.join(outputDir, "index.mdx"); + const indexContent = `--- +sidebar_position: 1 +--- + +# Data Points + +Explore data indexed by Talent at [https://talent.app/~/data](https://talent.app/~/data). +`; + fs.writeFileSync(indexFilePath, indexContent); + console.log(`Generated ${indexFilePath}`); + console.log("✅ Generation complete!"); }); cli @@ -80,7 +93,8 @@ ${dataIssuer.description || `${dataIssuer.name} data points`} if (fs.existsSync(outputDir)) { fs.readdirSync(outputDir).forEach((file) => { const filePath = path.join(outputDir, file); - if (filePath.endsWith(".mdx")) { + // Preserve index.mdx - don't delete it + if (filePath.endsWith(".mdx") && file !== "index.mdx") { console.debug(`Removing file: ${filePath}`); // Remove the file fs.unlinkSync(filePath); From 07938e4175a9f31eff31a40f888ef269c1b765a8 Mon Sep 17 00:00:00 2001 From: Ruben Dinis Date: Mon, 2 Feb 2026 18:50:33 +0000 Subject: [PATCH 09/10] Filter out Data Points category from sidebar completely --- docusaurus.config.js | 38 +++++++++++++++++++++++--------------- 1 file changed, 23 insertions(+), 15 deletions(-) diff --git a/docusaurus.config.js b/docusaurus.config.js index 19acf50..1e40afe 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -12,23 +12,31 @@ import webpack from "webpack"; // This runs in Node.js - Don't use client-side code here (browser APIs, JSX...) const replaceAutogeneratedWithSidebarFile = (sidebarItems) => { - return sidebarItems.map((item) => { - if (Array.isArray(item.items)) { - if (item.customProps?.autogenerate === false) { - const fs = require("fs"); - const path = require("path"); - const sidebarFilePath = path.resolve(item.customProps.sidebarFile); - const sidebarModule = require(sidebarFilePath); - item.items = sidebarModule.default || sidebarModule; - return item; - } else { - item.items = replaceAutogeneratedWithSidebarFile(item.items); - return item; + return sidebarItems + .filter((item) => { + // Filter out Data Points category entirely + if (item.label === "Data Points" || item.id === "data-points") { + return false; + } + return true; + }) + .map((item) => { + if (Array.isArray(item.items)) { + if (item.customProps?.autogenerate === false) { + const fs = require("fs"); + const path = require("path"); + const sidebarFilePath = path.resolve(item.customProps.sidebarFile); + const sidebarModule = require(sidebarFilePath); + item.items = sidebarModule.default || sidebarModule; + return item; + } else { + item.items = replaceAutogeneratedWithSidebarFile(item.items); + return item; + } } - } - return item; - }); + return item; + }); }; /** @type {import('@docusaurus/types').Config} */ From 7acb8504b55dfeebb00cb5a2a4c7f15930930a65 Mon Sep 17 00:00:00 2001 From: Ruben Dinis Date: Mon, 2 Feb 2026 18:51:29 +0000 Subject: [PATCH 10/10] Add link to talent.app/~/data in Data Point concept page --- docs/protocol-concepts/data-point.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/protocol-concepts/data-point.mdx b/docs/protocol-concepts/data-point.mdx index e1838e2..28c025d 100644 --- a/docs/protocol-concepts/data-point.mdx +++ b/docs/protocol-concepts/data-point.mdx @@ -6,6 +6,8 @@ sidebar_position: 4 A Data Point is specific type of reputation data about a given user. +Explore data indexed by Talent at [https://talent.app/~/data](https://talent.app/~/data). + ## Key Attributes: - A Data Point provides a verified fact about a user's reputation at a given point in time.