Skip to content

Add Interactive Tech Radar to Engineering Documentation Site #10

@timwright12

Description

@timwright12

As an engineer I want an interactive tech radar integrated into our engineering documentation site
So that I can quickly understand which technologies we use, what we recommend, and how each fits into our broader engineering strategy.

Problem / Rationale

Engineers need clarity around the technologies our organization adopts, trials, assesses, or avoids. A tech radar provides a common framework for exploration and helps engineering leads document technology choices in a consistent, discoverable way.

Scope

Integrate an interactive tech radar, from ThoughtWorks’ implementation, into the engineering documentation site. The radar will be maintained by engineering leads and will display technologies by Category, Ring, and Notes.

Image

Acceptance Criteria

  • A page exists on the engineering documentation site that displays an interactive tech radar based on the ThoughtWorks implementation.
  • The tech radar loads its data from a configurable JSON or YAML file stored in the docs repository.
  • Each radar item includes:
    • Category (e.g., Languages, Frameworks, Platforms, Techniques)
    • Ring (Adopt / Trial / Assess / Hold)
    • Notes (short explanation or context)
  • Radar visualization is fully interactive:
    • Hover states show details
    • Clicking an item shows its notes
    • Clicking an item shows its notes
    • Zoom/pan or grouping behaves as expected (matching ThoughtWorks baseline functionality)
  • Page is accessible:
    • Keyboard navigable
    • Screen reader labels for technologies and rings
  • Update the radar by editing the configuration file and submitting a PR.
  • Documentation exists in the repo describing:
    • How to update or add items
    • Naming conventions
    • Expected use of Category and Ring

Non-Goals

  • Automated population from code analysis
  • Version tracking or change history beyond Git
  • Governance workflow or approval automation

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions