Merge pull request #164 from mgifford/copilot/update-documentation-links

Surface analytics.usa.gov alongside DAP in README and report pages

Author: mgifford

README.md

@@ -15,10 +15,14 @@ This project provides a daily, repeatable quality signal by:
 - aggregating quality and impact metrics,
 - publishing dated static reports and trend history.
 
-## DAP and related resources
+## Analytics program and related resources
 
+The traffic data used by this project comes from the **Digital Analytics Program (DAP)**, a U.S.
+government service that collects website usage data across participating federal agencies.
+The aggregated results are publicly available at [analytics.usa.gov](https://analytics.usa.gov/).
+
+- Analytics.USA.gov (public-facing traffic dashboard): https://analytics.usa.gov/
 - Digital Analytics Program (DAP): https://digital.gov/guides/dap/
-- Analytics.USA.gov overview: https://analytics.usa.gov/
 - DAP data endpoint configured in this repo: `src/config/prevalence.yaml`
 - ScanGov (accessibility scanner): https://github.com/GSA/scan-gov
 - Lighthouse: https://developer.chrome.com/docs/lighthouse/overview/
@@ -127,6 +131,7 @@ This project is transparent about how AI tools have been used throughout its dev
 | Claude (Anthropic) | claude-sonnet-4.6 | CivicActions brand alignment: updated CSS color tokens (primary red #D83933, dark blue #162E51, secondary blue #1A4480), font stack (Public Sans), footer attribution, and tests in render-pages.js and index.html |
 | Claude (Anthropic) | claude-sonnet-4.6 | CI/CD improvements: added dedicated CI workflow for tests on PRs, upgraded accessibility scanner to v3, removed redundant push trigger from scan-github-pages workflow, added open-issues gate to prevent alert fatigue |
 | Claude (Anthropic) | claude-sonnet-4.6 | Added content density (Words-per-Megabyte) feature: integrated @mozilla/readability and jsdom to extract main-content word counts, compute WpM efficiency ratio, flag low-density pages (<200 WpM), and render a Content Density section in daily reports |
+| Claude (Anthropic) | claude-sonnet-4.6 | Added analytics.usa.gov links and references to README.md and report pages (renderDapContextSection and dashboard "What is DAP?" section) to better surface the public-facing traffic data site alongside the Digital Analytics Program documentation |
 | Claude (Anthropic) | claude-sonnet-4.6 | Improved test coverage: added 119 tests across 5 new test files for previously untested modules (slow-risk, logging, axe-fpc-mapping, build-daily-report, archive-writer); exported 3 helper functions from archive-writer.js for testability |
 | Claude (Anthropic) | claude-sonnet-4.6 | Added axe-core WCAG 2.2 AA accessibility tests for generated HTML: new tests/unit/axe-html-accessibility.test.js checks every render function using a minimal fixture report; fixed aria-prohibited-attr violations (aria-label on role-less spans) in render-pages.js |
 

src/publish/render-pages.js

@@ -2397,7 +2397,7 @@ function renderDapContextSection() {
   return `
   <section aria-labelledby="dap-context-heading">
     <h2 id="dap-context-heading">About These Reports${renderAnchorLink('dap-context-heading', 'About These Reports')}</h2>
-    <p>The <a href="https://digital.gov/guides/dap" target="_blank" rel="noreferrer"><strong>Digital Analytics Program (DAP)</strong></a> is a U.S. government analytics service that collects website traffic data across participating federal agencies. DAP tracks page views, visitor counts, and usage patterns for hundreds of government websites, providing transparency into how the public engages with federal digital services.</p>
+    <p>The <a href="https://digital.gov/guides/dap" target="_blank" rel="noreferrer"><strong>Digital Analytics Program (DAP)</strong></a> is a U.S. government analytics service that collects website traffic data across participating federal agencies. DAP tracks page views, visitor counts, and usage patterns for hundreds of government websites, providing transparency into how the public engages with federal digital services. The traffic data is publicly available at <a href="https://analytics.usa.gov/" target="_blank" rel="noreferrer">analytics.usa.gov</a>.</p>
     <p>This report measures the <strong>quality and accessibility</strong> of the top 100 most-visited U.S. government URLs as reported by DAP. Each day, Lighthouse scans are run against these URLs to measure:</p>
     <ul>
       <li><strong>Performance</strong> - How fast pages load for users (scores 0-100, higher is better)</li>
@@ -3207,7 +3207,7 @@ export function renderDashboardPage({ latestReport, historyIndex = [], archiveUr
 
     <section aria-labelledby="about-heading">
       <h2 id="about-heading">What is DAP?${renderAnchorLink('about-heading', 'What is DAP?')}</h2>
-      <p>The <a href="https://digital.gov/guides/dap" target="_blank" rel="noreferrer"><strong>Digital Analytics Program (DAP)</strong></a> is a U.S. government analytics service that tracks website traffic across hundreds of participating federal agencies. It measures page views, visitor counts, and usage patterns for government websites, providing transparency into how the public engages with federal digital services.</p>
+      <p>The <a href="https://digital.gov/guides/dap" target="_blank" rel="noreferrer"><strong>Digital Analytics Program (DAP)</strong></a> is a U.S. government analytics service that tracks website traffic across hundreds of participating federal agencies. It measures page views, visitor counts, and usage patterns for government websites, providing transparency into how the public engages with federal digital services. The traffic data is publicly available at <a href="https://analytics.usa.gov/" target="_blank" rel="noreferrer">analytics.usa.gov</a>.</p>
       <p>This dashboard uses DAP traffic data to identify the <strong>most-visited government URLs</strong> and measures their quality daily. Each scan covers:</p>
       <ul>
         <li><strong>Accessibility</strong> &mdash; WCAG compliance measured by Lighthouse and axe-core (0&ndash;100, higher is better)</li>