Skip to content

enhanced api generation with techradar tool integration#134

Draft
vuillaut wants to merge 1 commit intomainfrom
techradar_tools_api
Draft

enhanced api generation with techradar tool integration#134
vuillaut wants to merge 1 commit intomainfrom
techradar_tools_api

Conversation

@vuillaut
Copy link
Copy Markdown
Contributor

@vuillaut vuillaut commented Feb 26, 2026

Enriches both dimensions and indicators APIs with tool relationships from the TechRadar repository, providing automated discovery of which tools measure, improve, or address each quality aspect.

The tools from the TechRadar are fetched using the GitHub api and then the inverse relationships are built into the global API:

  • Indicators: Added measuredBy and improvedBy arrays showing which tools assess/enhance each indicator
  • Dimensions: Added tools array listing tools that address each quality dimension

Notes:

  • Updated scripts/README.md with tool integration details and output examples
  • No breaking changes to the existing API structure (only added fields)
  • no changes in base schemas, it uses the existing relationships measuresQualityIndicator, improvesQualityIndicator defined in the tools schema

TODO:

  • add the URL to each tool page in the TechRadar (once back up)
  • use this to display the tools in the indicators page (another PR)

Fixes #133

@vuillaut vuillaut marked this pull request as draft February 26, 2026 11:36
@dgarijo
Copy link
Copy Markdown
Contributor

dgarijo commented Feb 26, 2026

I need to review this, because it adds two new properties to the schemas

@vuillaut
Copy link
Copy Markdown
Contributor Author

I need to review this, because it adds two new properties to the schemas

No, no, the schema does not change, only the built API that is used for the webpage.

The source of truth for linking tools to indicators is in the TechRadar repo and the tools schema, and it hasn't changed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Link indicator catalog to the TechRadar

2 participants