Skip to main content

Feature: Evidence Links

Purpose​

  • Feature name: Evidence links
  • Why this feature exists: Make documentation artifacts discoverable directly from the app.

Scope​

In scope​

  • links to dossier pages
  • links to ADR and runbook indexes
  • evidence callouts on core pages

Out of scope​

  • registry validation logic
  • documentation site navigation

Prereqs / Inputs​

  • docs base URL configured
  • evidence URLs present in registry or page content

Procedure / Content​

Feature summary​

  • Feature name: Evidence links
  • Feature group: Documentation and governance integration
  • Technical summary: Constructs links to /docs/... artifacts and surfaces them in the UI.
  • Low-tech summary: Buttons and links that take reviewers to the proof.

Feature in action​

  • Where to see it working: /, /cv, and /projects/[slug] pages.

Confirmation Process​

Manual​

  • Steps: Click evidence links from core pages and verify they resolve.
  • What to look for: Links open the correct docs section without 404s.
  • Artifacts or reports to inspect: E2E evidence link checks.

Tests​

Potential behavior if broken or misconfigured​

  • Evidence links point to incorrect docs paths.
  • Missing docs base URL causes fallback to /docs.

Long-term maintenance notes​

  • Update evidence URLs when documentation moves.
  • Re-validate links after docs restructure.

Dependencies, libraries, tools​

  • Next.js App Router
  • React

Source code references (GitHub URLs)​

ADRs​

  • None.

Runbooks​

  • None.

Additional internal references​

Validation / Expected outcomes​

  • Evidence links resolve to the correct docs pages.

Failure modes / Troubleshooting​

  • Broken links: update docs base URL and registry entries.

References​

  • None.