You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@community.apache.org by rb...@apache.org on 2026/09/17 20:16:22 UTC

(comdev-metrics) branch main updated: Document JSON data API on About page

This is an automated email from the ASF dual-hosted git repository.

rbowen pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/comdev-metrics.git


The following commit(s) were added to refs/heads/main by this push:
     new 2513def  Document JSON data API on About page
2513def is described below

commit 2513def3bb2e4d2f8f51ef409cc8983a710f2e02
Author: Rich Bowen <rb...@rcbowen.com>
AuthorDate: Thu Sep 17 16:16:11 2026 -0400

    Document JSON data API on About page
    
    List all published JSON files with URL patterns and descriptions
    so people can consume the data directly for their own analysis.
---
 site/about.html | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/site/about.html b/site/about.html
index 8b5e08f..9801d70 100644
--- a/site/about.html
+++ b/site/about.html
@@ -160,6 +160,63 @@
         </ul>
     </div>
 
+    <div class="section">
+        <h2>JSON Data API</h2>
+        <p>All data is published as static JSON files under
+        <a href="data/"><code>data/</code></a> and can be consumed directly
+        for your own analysis. No API key required.</p>
+
+        <h3>Per-project files</h3>
+        <table>
+            <thead><tr><th>URL pattern</th><th>Contents</th></tr></thead>
+            <tbody>
+                <tr>
+                    <td><code>data/{project}.json</code></td>
+                    <td>Mailing list stats — active lists, message counts, monthly breakdown</td>
+                </tr>
+                <tr>
+                    <td><code>data/{project}_git.json</code></td>
+                    <td>Git activity — commits, committers, PRs per repo, monthly breakdown</td>
+                </tr>
+            </tbody>
+        </table>
+        <p>For example:
+            <a href="data/accumulo.json"><code>data/accumulo.json</code></a>,
+            <a href="data/accumulo_git.json"><code>data/accumulo_git.json</code></a>
+        </p>
+
+        <h3>Foundation-wide files</h3>
+        <table>
+            <thead><tr><th>URL</th><th>Contents</th></tr></thead>
+            <tbody>
+                <tr>
+                    <td><a href="data/_foundation.json"><code>data/_foundation.json</code></a></td>
+                    <td>Roster changes — new committers and PMC members with dates and project affiliation</td>
+                </tr>
+                <tr>
+                    <td><a href="data/_cache/mailing_summary.json"><code>data/_cache/mailing_summary.json</code></a></td>
+                    <td>All projects' mailing list totals in one file (used by the overview page)</td>
+                </tr>
+                <tr>
+                    <td><a href="data/_cache/committees.json"><code>data/_cache/committees.json</code></a></td>
+                    <td>Committee metadata — roster, chair, established date, reporting cycle</td>
+                </tr>
+                <tr>
+                    <td><a href="data/_cache/releases.json"><code>data/_cache/releases.json</code></a></td>
+                    <td>Release history for all projects</td>
+                </tr>
+                <tr>
+                    <td><a href="data/_cache/project_health.json"><code>data/_cache/project_health.json</code></a></td>
+                    <td>Activity trend classifications — declining, at-risk, and dormant projects with trend data</td>
+                </tr>
+                <tr>
+                    <td><a href="data/_project_map.json"><code>data/_project_map.json</code></a></td>
+                    <td>GitHub repo → project mapping (3000+ repos classified into projects)</td>
+                </tr>
+            </tbody>
+        </table>
+    </div>
+
     <div class="section">
         <h2>Source Code</h2>
         <p>The collector and dashboard are open source:</p>