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>